AI导哈

简道云数据操作工具

简道云MCP服务器是一个让AI助手如Claude、Cursor等直接操作简道云数据的工具，支持表单、数据、流程等多种操作。

  • by wmxqaz1234
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 wmxqaz1234/jiandaoyun-mcp

使用说明

简道云 MCP 服务器

简道云 MCP 服务器 - 让 Claude、Cursor 等 AI 助手直接操作简道云数据

特性

  • 17 个工具（表单、数据、流程、通讯录）
  • STDIO 本地 + HTTP/SSE 远程双模式
  • 客户端传递 API Key，支持多用户
  • 智能字段匹配（无需 widget_id）
  • 文件自动上传

快速开始

git clone https://github.com/wmxqaz1234/jiandaoyun-mcp.git
cd jiandaoyun-mcp
docker-compose up -d --build

访问 http://localhost:3001/health 检查状态。

主要端点

端点 说明
GET /health 健康检查
GET /sse MCP SSE 连接
POST /api/tools/:name 调用工具

核心工具

工具 说明
list_apps_and_forms 应用和表单列表
submit_form_data 提交数据
query_form_data 查询数据
get_upload_token 文件上传

快速示例

# 提交数据
submit_form_data(
    formId="xxx",
    data={"姓名": "张三", "电话": "13800138000"}
)

# 上传文件（注意：transactionId 必须一致）
txn = "unique-id-123"
file = get_upload_token(filePath="/path/to/file.jpg", transactionId=txn)
submit_form_data(data={"附件": file["field_value"]}, transactionId=txn)

API Key 认证

  • Authorization: Bearer <key> (推荐)
  • X-Api-Key: <key>
  • api_key=<key> (仅 SSE)

配置与部署

许可证

MIT

相关 MCP