基本能力
产品定位
简道云MCP服务是一个专门用于管理简道云表单数据的服务,支持完整的CRUD操作和高级查询功能。
核心功能
- 🔍 表单字段查询:检索表单的字段定义,包括字段类型、必填状态等。
- 📝 智能数据提交:自动匹配字段类型并转换数据格式。
- 🔄 批量操作支持:支持单条或批量提交/删除(最多100条)。
- 🎯 字段智能匹配:支持通过字段键、字段名等进行匹配。
- 🔐 安全认证:使用Bearer Token认证机制。
- 📊 高级查询:支持数据过滤器、分页查询。
- 📁 文件上传:获取文件上传凭证。
适用场景
- 需要与简道云表单进行深度集成的应用。
- 需要批量处理简道云表单数据的场景。
- 需要高级查询和过滤简道云表单数据的应用。
工具列表
- get_form_fields:检索表单的字段定义信息。
- submit_form_data:向表单提交数据,支持自动字段类型匹配。
- get_form_data:从表单中检索特定的数据记录。
- query_form_data:查询多条数据记录,支持过滤和分页。
- update_form_data:更新现有的数据记录。
- delete_form_data:删除一条或多条数据记录。
- get_upload_token:获取文件上传令牌。
- list_apps_and_forms:列出所有可访问的应用程序,或获取指定应用程序下的表单列表。
使用教程
使用依赖
安装Node.js环境。
安装教程
cd jiandaoyun-mcp-server
npm install
npm run build配置
在使用前,需要设置简道云API密钥作为环境变量:
export JIANDAOYUN_APP_KEY="your_app_key"
export JIANDAOYUN_BASE_URL="https://api.jiandaoyun.com/api" # 可选或者在.env文件中设置:
JIANDAOYUN_APP_KEY=your_app_key
JIANDAOYUN_BASE_URL=https://api.jiandaoyun.com/api调试方式
# 开发模式
npm run dev
# 构建
npm run build
# 启动服务
npm start