Zoho CRM MCP demo

一个迷你的 MCP 服务器，把四个 Zoho CRM 操作（Deals 和 Leads 模块，使用真实 Zoho API v8 字段名）暴露为工具，供 LLM/智能体以自然语言调用：

• search_deals(stage=None, min_amount=None) — 按阶段/金额筛选交易管道

• summarize_pipeline() — 按阶段统计交易数量 + 总金额（Amount），并区分未结与已结

• find_duplicate_leads() — 按 (Email, Company) 分组 Leads，以捕获同一联系人通过两个不同捕获渠道进入、且姓名拼写略有不同的情况（例如 Marketplace 扩展表单 vs. webhook）

• create_lead(first_name, last_name, company, email, lead_source) — 添加一条 Lead

为什么有它

这是一个简短、自包含的概念验证，不代表绑定到任何具体客户工作的交付物。它完全运行在 data/seed.json 中的合成数据集之上；不连接任何真实的 Zoho CRM 组织，也不涉及任何 CRMOZ 或客户数据。

它采用了其他已上线的生产级 MCP 工作（n8n MCP 集成、为真实客户构建的 GoHighLevel MCP 集成）相同的模式——这里应用到 Zoho CRM 的数据结构上，目的是展示该模式的通用性，而不是替代任何已有的“AI + Zoho”工具。

Related MCP server: Zoho CRM MCP Server

运行它

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python3 server.py

这会以 stdio 方式启动服务器，随时可以作为一种本地服务器添加到任意 MCP 客户端（Claude Desktop、Claude Code 等）的配置中。

已验证可用

四个工具均已直接调用，并已通过 mcp.list_tools() 验证——search_deals、summarize_pipeline、find_duplicate_leads 和 create_lead 全部成功注册，并针对种子数据返回了正确输出；其中还包括一条故意植入的重复 lead（sam.cutter@bramwellfoods.example，一次通过 “Email to Lead” 风格的渠道进入，一次通过 “Google Sheets” 风格的渠道进入，姓名拼写分别为 “Sam” 和 “Samuel”），而 find_duplicate_leads() 正确地捕获了它。