MCP server for kintone サンプル - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

kintone-mcp-server 是一个用于与 kintone 平台集成的 MCP 服务器，旨在通过生成AI自动创建的功能，使 Claude Desktop 应用能够访问和更新 kintone 数据。

核心功能

• 记录操作: 获取、搜索、创建、更新记录，以及添加记录评论。
• 文件操作: 上传和下载文件。
• 应用信息: 获取应用信息、表单布局等。
• 应用操作: 创建应用、添加字段、更新字段、部署应用等。
• 空间操作: 获取和更新空间信息、管理空间成员、添加线程和评论等。
• 用户和组信息: 获取用户、组和组成员信息。
• kintone连接信息: 获取连接域名和用户名。

适用场景

• 通过 Claude Desktop 应用访问和更新 kintone 数据。
• 自动化 kintone 应用的管理和操作。
• 集成 kintone 数据到其他应用或服务中。

工具列表

• get_record: 获取单条记录。
• search_records: 搜索记录。
• create_record: 创建新记录。
• update_record: 更新记录。
• add_record_comment: 添加记录评论。
• upload_file: 上传文件。
• download_file: 下载文件。
• get_apps_info: 获取应用信息。
• get_form_layout: 获取表单布局。
• create_app: 创建新应用。
• add_fields: 添加字段。
• update_field: 更新字段。
• update_form_layout: 更新表单布局。
• update_app_settings: 更新应用设置。
• deploy_app: 部署应用。
• get_deploy_status: 获取部署状态。
• move_app_to_space: 移动应用到空间。
• move_app_from_space: 从空间移除应用。
• get_space: 获取空间信息。
• update_space: 更新空间设置。
• update_space_body: 更新空间正文。
• get_space_members: 获取空间成员。
• update_space_members: 更新空间成员。
• add_thread: 添加线程。
• update_thread: 更新线程。
• add_thread_comment: 添加线程评论。
• add_guests: 添加访客。
• update_space_guests: 更新空间访客。
• get_users: 获取用户信息。
• get_groups: 获取组信息。
• get_group_users: 获取组成员。
• get_kintone_domain: 获取连接域名。
• get_kintone_username: 获取连接用户名。

常见问题解答

• 需要 Claude Pro 订阅才能使用 Claude Desktop 应用作为客户端。
• 当前实现中，1MB以上的文件可能无法正常下载。
• 不支持个别设置内容的咨询或环境问题的解决。

使用教程

使用依赖

• Node.js 18 或更高版本。

安装教程

1. 下载源代码到不含空格的全英文路径。
2. 安装 Node.js 18 或更高版本。
3. 运行以下命令安装依赖：
   bash
npm i
4. 编辑 Claude Desktop 应用的配置文件 claude_desktop_config.json，添加以下内容：
   json
{
"mcpServers": {
"kintone": {
"command": "node",
"env": {
"KINTONE_DOMAIN": "[你的子域名].cybozu.com",
"KINTONE_USERNAME": "MCP连接使用的kintone用户名",
"KINTONE_PASSWORD": "kintone用户密码（明文）"
},
"args": [
"[kintone-mcp-server路径]/server.js"
]
}
}
}
5. 保存配置文件后，重启 Claude Desktop 应用。

调试方式

1. 在 Claude 中询问 "kintone应用「[应用名]」的应用ID" 以确认连接。
2. 确保应用名准确无误。