剪贴板图像识别服务

一款能够自动识别剪贴板中的图像并与Claude Code交互进行即时分析的MCP服务器。

  • by charles69729798
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 charles69729798/clipboard-mcp-server

使用说明

📋 剪贴板MCP服务器

Win+Shift+S让Claude Code立即识别用捕获的画面的MCP服务器

主要功能

  • 🖼️ 自动识别剪贴板图像:用Win+Shift+S截图,Claude会立即进行分析
  • 🪟 捕获窗口:直接捕获当前打开的特定窗口(HWP、Excel等)
  • 📝 优化韩文识别:通过PNG无损格式提高文本识别率
  • 🚀 易于使用:在没有单独保存的情况下截图后立即与Claude对话

🎯 使用方案

1. HWP 파일에서 수학식 보는 중
2. Win+Shift+S로 영역 드래그 캡처
3. Claude Code: "클립보드 이미지 보여줘"
4. ✅ Claude가 즉시 수식 분석 & LaTeX 변환!

📦 安装

1.克隆存储库

git clone https://github.com/charles69729798/clipboard-mcp-server.git
cd clipboard-mcp-server

2.创建虚拟环境并安装软件包

# Windows
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

# macOS/Linux
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3.Claude Code设置

C:\Users\YOUR_USERNAME\.claude.json 将以下内容添加到文件:

{
  "mcpServers": {
    "clipboard-image": {
      "type": "stdio",
      "command": "C:\\clipboard-mcp-server\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\clipboard-mcp-server\\clipboard_mcp.py"
      ],
      "env": {}
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "clipboard-image": {
      "type": "stdio",
      "command": "/path/to/clipboard-mcp-server/.venv/bin/python",
      "args": [
        "/path/to/clipboard-mcp-server/clipboard_mcp.py"
      ],
      "env": {}
    }
  }
}

4.重新启动Claude Code

设置后重新启动Claude Code将自动加载MCP服务器。

💡 使用方法

📸 分析剪贴板图像

1. Win+Shift+S (Windows) 또는 Cmd+Shift+4 (Mac)로 화면 캡처
2. Claude Code에서 "클립보드 이미지 보여줘" 입력
3. Claude가 즉시 이미지 분석!

🪟 捕获特定窗口

# 1단계: 열린 창 목록 확인
사용자: "현재 열린 창 목록 보여줘"
Claude: [list_windows 도구 사용]
  1. 문서1.hwp - 한글
  2. 예산.xlsx - Excel
  3. Chrome - Google
  ...

# 2단계: 원하는 창 캡처
사용자: "한글 창 캡처해줘"
Claude: [capture_window 도구 사용하여 HWP 창 캡처 및 분석]

🛠️ 交付工具

1. paste_clipboard_image()

获取剪贴板上的图像,让Claude可以分析。

使用示例:

  • “请分析剪贴板图像”
  • “把刚才截图的公式转换成LaTeX”
  • “提取图像中的文本”

2. list_windows()

返回当前打开的所有窗口的列表。

返回信息:

  • 窗口标题
  • 尺寸(width x height)
  • 位置(x,y)

3. capture_window(window_title)

浏览特定窗口并捕获屏幕截图。

参数:

  • window_title:窗口标题的一部分(例如“韩文”、“Excel”、“.hwp”)

示例:

capture_window("한글")      # "한글"이 포함된 창 캡처
capture_window(".hwp")      # .hwp 확장자 파일이 열린 창 캡처
capture_window("Excel")     # Excel 창 캡처

📋 实际使用案例

示例1:数学解题

사용자: [수식 캡처] "이 미분방정식 풀어줘"
Claude: [이미지 분석]
  "dy/dx + 2y = e^x

  이것은 1차 선형 미분방정식입니다.
  풀이:
  1. 적분인자: μ(x) = e^(2x)
  2. 일반해: y = (e^x)/3 + Ce^(-2x)
  ..."

示例2:提取表格数据

사용자: [Excel 표 캡처] "이 표를 마크다운으로 변환해줘"
Claude: [변환 결과 제공]

示例3:查看实时文档

사용자: "한글 문서 열린 창 캡처해서 오타 찾아줘"
Claude: [HWP 창 캡처 후 텍스트 분석 및 오타 지적]

🔧 技术堆栈

  • FastMCP:模型上下文协议(MCP)服务器框架
  • 枕头(PIL):图像处理和剪贴板访问
  • pygetwindow:管理Windows窗口
  • Python 3.8+

📝 工作原理

┌──────────────┐
│   사용자      │
│ Win+Shift+S  │  → 화면 드래그 캡처
└──────────────┘
       ↓
┌──────────────┐
│   Windows    │
│  Clipboard   │  ← 자동으로 이미지 저장
└──────────────┘
       ↓
┌──────────────┐
│  MCP Server  │
│ (clipboard_  │  ← ImageGrab.grabclipboard()
│  mcp.py)     │
└──────────────┘
       ↓
┌──────────────┐
│ Claude Code  │  ← paste_clipboard_image() 호출
└──────────────┘
       ↓
   이미지 분석!

高级设置

更改图像大小限制

clipboard_mcp.py 调整文件的第37行:

max_size = 2048  # 기본값: 2048px (Claude 제한 고려)

更改重新取样方法

如果需要高质量图像,第41行:

img = img.resize(new_size, Image.Resampling.LANCZOS)  # LANCZOS 권장

🐛 故障排除

MCP服务器未加载时

# .claude.json 파일 경로 확인
# Windows: C:\Users\YOUR_USERNAME\.claude.json
# macOS: ~/.claude.json

# 절대 경로가 정확한지 확인
# 경로에 한글이 있으면 이스케이프 처리 필요

无法识别剪贴板图像时

# test_clipboard.py 실행하여 확인
python test_clipboard.py

# 출력 예상:
# "Test image copied to clipboard!"
# "Successfully read back image: (400, 200)"

窗口捕获不起作用时

  • 确保您要捕获的窗口未最小化
  • 以管理员权限运行的程序可能会限制捕获
  • list_windows()在确认正确的窗口标题后使用

🤝 贡献

  1. 分叉项目
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支机构(git push origin feature/AmazingFeature)
  5. 打开拉取请求

📄 许可证

MIT License-自由使用!

🙏 感谢

📞 咨询

如果有问题或建议 问题请在注册!


如果对您有帮助的话,请点击Star!