使用说明
📋 剪贴板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()在确认正确的窗口标题后使用
🤝 贡献
- 分叉项目
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支机构(
git push origin feature/AmazingFeature) - 打开拉取请求
📄 许可证
MIT License-自由使用!
🙏 感谢
📞 咨询
如果有问题或建议 问题请在注册!
如果对您有帮助的话,请点击Star!
