Zoho时间轴MCP服务器
MCP（模型上下文协议）服务器，使Claude Desktop能够交互式捕获和分析Zoho CRM时间线截图。
特性
- 交互式屏幕截图：点击Zoho CRM窗口，让Claude捕获它们
- 自动OCR和解析：提取时间线事件、工作流和函数
- 时序分析：对事件进行排序并识别模式
- 导出为多种格式：JSON和Markdown报告
先决条件
- Python 3.10+
- 克劳德桌面版 （有MCP支持）
- 无烟煤API密钥
- Tesseract OCR （用于文本提取）
- Windows：从下载https://github.com/UB-Mannheim/tesseract/wiki - 添加到路径： C:\Program Files\Tesseract-OCR
安装
1.安装Tesseract OCR
从以下位置下载并安装Tesseract： https://github.com/UB-Mannheim/tesseract/wiki
确保在安装过程中将其添加到PATH中。
2.克隆或下载此项目
cd %USERPROFILE%\Documents
# If you received this as a zip, extract it here
# Or if in a git repo: git clone zoho-timeline-mcp
cd zoho-timeline-mcp3.创建虚拟环境
python -m venv venv
venv\Scripts\activate4.安装依赖项
pip install -e .5.安装Windows特定依赖项
对于Windows上的活动窗口捕获：
pip install pywin326.设置Anthropic API密钥
创建一个 .env 项目根目录中的文件：
ANTHROPIC_API_KEY=your_api_key_here或者将其设置为环境变量：
setx ANTHROPIC_API_KEY "your_api_key_here"Claude桌面配置
将此添加到您的Claude Desktop配置文件中：
地点： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"zoho-timeline": {
"command": "python",
"args": [
"-m",
"zoho_timeline_mcp.server"
],
"cwd": "C:\\Users\\YourUsername\\Documents\\zoho-timeline-mcp",
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
}
}
}
}重要提示： 替换 YourUsername 和 your_api_key_here 与你的实际价值观。
用法
1.启动克劳德桌面
配置后，重新启动Claude Desktop。MCP服务器将自动启动。
2.截图
在Claude Desktop中，说：
Capture a screenshot of the Zoho timeline克劳德将：
- 捕获活动窗口
- 暂时保存
- 询问是否要捕获更多
3.捕获多个屏幕截图
继续捕捉：
Capture another screenshot或者点击时间线的下一部分，然后说：
Capture this screen too4.流程时间表
捕获完成后：
Process the timeline screenshots克劳德将：
- 使用视觉API分析所有屏幕截图
- 按时间顺序提取时间线事件
- 确定工作流程和功能
- 返回全面的JSON和报告
5.导出结果
Export the results to files文件保存到： %USERPROFILE%\Documents\ZohoTimelineAnalysis\
可用工具
MCP服务器为Claude提供以下工具：
capture_screenshot
捕获活动窗口或全屏的屏幕截图。
参数：
capture_type：“active_window”或“全屏”（默认值：“active_window”）
list_screenshots
列出所有捕获的带有ID和时间戳的屏幕截图。
process_timeline
处理所有捕获的屏幕截图并提取时间线数据。
参数：
api_key：可选的Anthropic API密钥（如果未提供，则使用env var）
clear_screenshots
清除所有捕获的屏幕截图以重新开始。
export_results
将时间线分析导出为JSON和Markdown文件。
参数：
output_dir：可选输出目录（默认：Documents/ZohoTimelineAnalysis）
输出格式
时间线JSON
{
"lead_timeline": {
"date": "Nov 25, 2025",
"events": [
{
"timestamp": "02:30 PM",
"event_type": "Lead Created",
"action": "Lead Created",
"triggered_by": "Function",
"function_name": "Leads CR Process Power Almanac Files"
},
...
]
}
}工作流程和函数JSON
{
"workflow_rules": {
"count": 13,
"list": [
"Leads - Cr - Format Phone",
...
]
},
"functions": {
"count": 9,
"list": [
"Lead_VerifyEmailHunterIO",
...
]
}
}故障排除
未捕获的屏幕截图
- 确保Zoho窗口处于活动状态且可见
- 尝试全屏模式：
capture_type: "full_screen" - 检查是否安装了mss库：
pip install mss
pywin32错误
如果你收到关于pywin32的错误：
python venv\Scripts\pywin32_postinstall.py -installAPI关键问题
验证您的API密钥是否已设置：
echo %ANTHROPIC_API_KEY%未找到Tesseract
确保Tesseract已安装并位于您的PATH中：
tesseract --version如果未找到，请添加到PATH：
C:\Program Files\Tesseract-OCRMCP服务器未启动
- 检查克劳德桌面日志：
%APPDATA%\Claude\logs - 手动测试服务器：
python -m zoho_timeline_mcp.server- 验证配置文件语法（必须是有效的JSON）
工作流示例
User: "Capture the current Zoho timeline window"
Claude: [captures screenshot] ✓ Screenshot 1 captured. Ready for another?
User: "Scroll down and capture the next section"
Claude: [captures screenshot] ✓ Screenshot 2 captured. Continue?
User: "One more"
Claude: [captures screenshot] ✓ Screenshot 3 captured. Ready to process?
User: "Process all the screenshots"
Claude: [processes with vision API] ✓ Timeline analyzed!
Found 13 workflow rules and 9 functions...
[displays full report]
User: "Export these results"
Claude: ✓ Saved to Documents\ZohoTimelineAnalysis\发展
运行测试
pytest代码格式化
black src/许可证
MIT许可证-可根据需要自由修改和使用。
支持
对于问题或疑问：
- 检查故障排除部分
- 查看克劳德桌面MCP日志
- 在独立模式下测试服务器
路线图
- \[\]支持多台显示器
- \[\]自动滚动检测
- \[\]批量处理保存的屏幕截图
- \[\]导出为Excel格式
- \[\]基于模板的报告生成
- \[\]与Zoho API集成以进行验证