AI导哈

CRM协议服务器

Zoho CRM MCP Server是一个将Zoho CRM v6 REST API暴露为结构化工具供LLM代理使用的模型上下文协议服务器。

  • by LokiMCPUniverse
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 LokiMCPUniverse/zoho-crm-mcp-server

使用说明

Zoho CRM MCP服务器

模型上下文协议（MCP）服务器，用于公开Zoho CRM v6REST API 作为LLM代理的结构化工具。基于FastMCP和异步httpx构建， pydantic v2配置和OAuth2刷新令牌流。

特性

  • OAuth2刷新令牌交换与内存访问令牌缓存（1小时TTL）
  • 强制令牌刷新后，在HTTP 401上自动重试一次
  • 键入错误(AuthenticationError, NotFoundError, RateLimitError, APIError)
  • 区域感知端点： com, eu, in, com.au, jp
  • 任何CRM模块的完整CRUD，加上搜索、COQL、模块元数据， 用户列表和相关列表遍历

需求

  • Python 3.10+
  • mcp>=1.27,<2
  • httpx>=0.27.1,<1.0.0
  • pydantic>=2.12, pydantic-settings>=2.5.2

安装

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

配置

所有设置都使用 ZOHO_ env前缀（或 .env 文件）：

变量 默认值 描述
ZOHO_CLIENT_ID OAuth2客户端id
ZOHO_CLIENT_SECRET - OAuth2客户端机密
ZOHO_REFRESH_TOKEN - OAuth2刷新令牌
ZOHO_REGION com 其中之一 com, eu, in, com.au, jp
ZOHO_TIMEOUT 30 HTTP超时（秒）

跑

zoho-crm-mcp

或者使用上面的stdio命令在支持MCP的客户端中注册它。

工具

工具 Zoho CRM端点
list_records GET /crm/v6/{module}
get_record GET /crm/v6/{module}/{id}
create_record POST /crm/v6/{module}
update_record PUT /crm/v6/{module}/{id}
delete_record DELETE /crm/v6/{module}/{id}
search_records GET /crm/v6/{module}/search
list_modules GET /crm/v6/settings/modules
get_module GET /crm/v6/settings/modules/{module}
list_users GET /crm/v6/users
coql_query POST /crm/v6/coql
list_related_records GET /crm/v6/{module}/{id}/{related_list}

测试

pytest -x --tb=short

许可证

麻省理工学院

相关 MCP