F
licenseNot graded
qualityD
maintenanceProvides live Zoho CRM data access via MCP tools, enabling queries on modules, records, fields, and related lists without syncing data.
-
Genesis-World-MCP
by Gnidreve
cas-genesisworld-mcp
将 Claude、Cursor 或任何兼容 MCP 的 AI 代理连接到您的 CAS genesisWorld CRM。通过自然语言搜索联系人、管理任务和约会、读取或写入记录——无需编写任何 API 调用。
69 个工具，包括 7 个原生流程，将多步骤 CRM 操作（例如在预订会议前检查日程冲突，或在创建联系人前检查重复项）打包为单次调用。
对任务、联系人、约会、文档、通讯组列表等拥有完整的读写权限——此外还可对您的安装所定义的任何自定义对象类型进行通用访问。
提供只读模式，适合安全、探索性的使用。
以现成的 Docker 镜像或 npm 包形式发布。
快速开始
将此内容添加到您的 MCP 客户端配置中（例如 Claude Desktop 的 claude_desktop_config.json）：
{
"mcpServers": {
"cas-genesisworld": {
"command": "npx",
"args": ["-y", "cas-genesis-world-mcp"],
"env": {
"GENESISWORLD_BASE_URL": "http://your-genesisworld-server/genesisrest.svc",
"GENESISWORLD_PRODUCT_KEY": "your-product-key",
"GENESISWORLD_USERNAME": "your-username",
"GENESISWORLD_PASSWORD": "your-password"
}
}
}
}重启客户端——工具会自动出现。让您的代理查找联系人、列出未完成任务或预订会议，它会自行完成后续操作。
更倾向于使用持久化、自托管的服务器，而不是每个客户端一个进程？请参阅下面的使用 Docker 自托管。
Related MCP server: Twenty CRM MCP
您可以要求它做什么
连接后，您的代理可以处理如下请求：
"查找 Jane Doe 的联系信息，并显示她的未完成任务。"
"为这个潜在客户创建后续任务，并将其链接到他们的联系人记录。"
"下周二上午 10 点与销售团队开会——先检查每个人的日历是否有冲突。"
"在为 Acme Corp 创建新联系人之前，检查是否有可能的重复项。"
"为此商机生成报告。"
此类请求由流程来响应——即单次工具调用，将人类原本需要手动编写脚本的多步骤 API 请求序列打包在一起。
工具与流程
流程——复合操作，一次调用
流程 | 模式 | 功能 |
| 读取 | 一次调用获取当前用户及其任务列表（截止窗口、已保存视图或全文筛选） |
| 读取 | 并行获取任务记录 + 链接 + 标签 |
| 写入 | 创建任务，并可选择将其链接到另一个对象（例如联系人） |
| 读取 | 按姓名和/或电话号码并行搜索联系人 |
| 读取 | 并行获取联系人 + 集合档案 + 标签 + 链接 |
| 写入 | 先进行重复检查——仅在未找到候选对象时才创建 |
| 写入 | 可选冲突检查 → 创建 → 添加参与者，一次调用完成 |
读取（39 个）
工具 | 端点 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 服务器本地的静态方向说明文档 |
写入（23 个——在只读模式下隐藏，连同上述写入流程一起）
工具 | 端点 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
此构建所基于的完整上游 API 已作为
swagger.json 提交。
资源
除工具外，服务器还公开了用于不常变化数据的 MCP 资源，这样你的代理就不必在每个会话中浪费工具调用来重新发现这些数据：
genesisworld://readme— 面向代理本身的静态定向文档（领域模型、导航模式、效率规则）。genesisworld://types— 用户可访问的数据对象类型及权限。缓存 15 分钟。genesisworld://metadata/{objectType}— 单一类型的字段/关系架构，例如genesisworld://metadata/ADDRESS。缓存 15 分钟。genesisworld://views/{objectType}— 单一类型的已保存视图，例如genesisworld://views/TASK。缓存 15 分钟。
使用 Docker 自托管
用于多个客户端可以指向的持久化服务器（而不是每个客户端一个 npx 进程）：
docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
-e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
-e GENESISWORLD_PRODUCT_KEY="your-product-key" \
-e GENESISWORLD_USERNAME="your-username" \
-e GENESISWORLD_PASSWORD="your-password" \
vaatu/cas-genesis-world-mcp
# Read-only mode: append --read-only after the image name
docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
-e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
-e GENESISWORLD_PRODUCT_KEY="your-product-key" \
-e GENESISWORLD_USERNAME="your-username" \
-e GENESISWORLD_PASSWORD="your-password" \
vaatu/cas-genesis-world-mcp --read-only多租户：一台服务器，多个 genesisWorld 身份
默认情况下，容器为每个连接的客户端提供一个固定的 genesisWorld 身份。使用 --client-credentials 时，它没有任何身份——每个客户端自行认证，因此一台服务器可以安全地为使用不同 genesisWorld 登录名的多个个人/团队提供服务：
docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
-e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
vaatu/cas-genesis-world-mcp --client-credentials然后，每个客户端在连接时通过请求头发送自己的凭据：
{
"mcpServers": {
"cas-genesisworld": {
"url": "http://localhost:8084/mcp",
"headers": {
"X-GenesisWorld-Username": "your-username",
"X-GenesisWorld-Password": "your-password"
}
}
}
}X-GenesisWorld-Product-Key 在此处是可选的——如果你在服务器上保持设置 GENESISWORLD_PRODUCT_KEY，则省略自己产品密钥的客户端将回退到该值。仅限 HTTP 传输（stdio 上没有按请求的头通道）；缺少用户名和密码头的请求会被直接拒绝（HTTP 401），它永远不会回退到共享身份。
MCP 端点现在位于 http://localhost:8084/mcp。将你的客户端指向它：
{
"mcpServers": {
"cas-genesisworld": {
"url": "http://localhost:8084/mcp"
}
}
}配置
两类设置严格分开——没有设置同时属于两类：环境变量配置部署（API 所在位置、谁连接）；启动选项在启动时切换行为。
环境变量
变量 | 必需 | 用途 |
| 是 | REST 服务的基础 URL，例如 |
| 是* | 在每个请求中作为 |
| 是* | 基本认证用户 |
| 是* | 基本认证密码 |
| 否 |
|
| 否 | HTTP 模式的绑定地址（默认 |
| 否 | 截断过大的响应（默认 60000 个字符； |
| 否 |
|
* 实际上，任何真实请求要成功都需要——除非在 --client-credentials 模式下（见下文），此时服务器没有自己的身份，这三个都不是必需的。
启动选项
标志 | 必需 | 用途 |
| 否 | 仅为该会话注册只读工具——修改工具不仅被阻止，它们根本不存在 |
| 否 | 服务器不持有固定的 genesisWorld 身份；每个 HTTP 客户端通过请求头自行认证（见上文"多租户"）。仅限 HTTP 传输 |
在命令行中传递启动选项，或在 docker run 中的镜像名称之后传递（如上所示）。按照设计，它们都没有对应的环境变量。
许可证
想要添加工具或了解其构建方式？请参阅 AGENTS.md 了解架构和贡献者文档，以及 ROADMAP.md 了解项目计划。
This server cannot be deployed
Maintenance
ActivityStale
ResponsivenessSyncing
Related MCP Connectors
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Read contacts, projects, documents and log entries, and run read-only queries in HERO Software.
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Browse AFAS connectors, read their fields and records in AFAS Software.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables MCP clients to read, search, create, update, and manage records in Twenty CRM with a safe, composable 14-tool interface and guarded destructive operations.143MIT
- FlicenseNot gradedqualityCmaintenanceRead-only MCP server for DocuWare that lets you list file cabinets, search documents, view metadata, and download documents.-
- FlicenseNot gradedqualityCmaintenanceProvides read-only MCP tools to find, list, and retrieve sales case studies with hybrid search, returning complete cases and prepared presentations.-