金通-MCP服务器

Name: 金通-MCP服务器
Author: r3-yamauchi

作者：r3-yamauchi10 星标更新：2025-11-21

安装使用来源：spider==github.com

项目介绍

技术文档摘要

MCP服务器用于kintone 示例（非官方）

这是一个可以与kintone集成使用的Model Context Protocol (MCP)服务器示例代码。

通过使用这个MCP服务器，可以从支持MCP的桌面应用程序（如Claude Desktop）中访问和更新kintone数据，甚至创建kintone应用。该服务器经过优化，使大型语言模型能够顺畅地处理kintone。

Cybozu已正式发布了官方的MCP服务器。 如果没有特殊原因，建议使用官方的MCP服务器。

使用mcpb文件（以前是dxt扩展名）安装到Claude Desktop应用（推荐）

从https://github.com/r3-yamauchi/kintone-mcp-server/releases下载最新的unofficial-kintone-mcp-server-8.0.0.mcpb，然后点击Claude Desktop应用中的[设置] -> [桌面应用] - [扩展功能]。

<img height="500" src="docs/images/mcpb-install0.png" alt="通过拖放mcpb文件进行安装" style="margin-bottom: 1.6rem;" />

如果显示“请将.MCPB或.DXT文件拖放到这里进行安装”，请将下载的unofficial-kintone-mcp-server-8.0.0.mcpb文件拖放到此处。

如果没有显示“请将.MCPB或.DXT文件拖放到这里进行安装”，请点击“详细设置”，然后点击“安装扩展功能...”，并选择下载的unofficial-kintone-mcp-server-8.0.0.mcpb文件。

<img height="500" src="docs/images/mcpb-install1.png" alt="桌面应用的扩展功能设置" style="margin-bottom: 1.6rem;" />   <img height="600" src="docs/images/mcpb-install2.png" alt="通过mcpb文件进行安装" style="margin-bottom: 1.6rem;" />

点击“安装”。

<img height="500" src="docs/images/mcpb-install3.png" alt="输入连接到kintone的信息" style="margin-bottom: 1.6rem;" />

输入要连接的kintone域名、用户名和密码，然后点击“保存”按钮。

<img height="500" src="docs/images/mcpb-install4.png" alt="输入连接到kintone的信息" style="margin-bottom: 1.6rem;" />   <img height="500" src="docs/images/mcpb-install5.png" alt="输入连接到kintone的信息并点击保存" style="margin-bottom: 1.6rem;" />

点击右侧的开关将其切换为“有效”，然后关闭设置界面。

<img height="300" src="docs/images/mcpb-install6.png" alt="切换为有效" style="margin-bottom: 1.6rem;" />

打开新的聊天窗口。点击工具图标可以看到已加载的扩展功能（MCP服务器）列表。如果“unofficial-kintone-mcp-server”已启用，则可以开始使用。

<img height="300" src="docs/images/tool.png" alt="已加载的扩展功能（MCP服务器）列表" style="margin-bottom: 1.6rem;" />

点击“unofficial-kintone-mcp-server”右侧的“>”，可以看到可用的工具列表。如果有不想使用的工具，请将其禁用。

<img height="300" src="docs/images/tools.png" alt="工具列表" style="margin-bottom: 1.8rem;" />

不使用mcpb文件的本地安装步骤

1. 要求

Node.js 20 或更高版本
pnpm 或 npm

2. 下载源代码

下载位置不限，但建议放在一个没有空格且仅包含半角英数字符的路径下。

3. 安装依赖项

pnpm install

或者

npm install

4. 编辑Claude Desktop应用的配置文件

找到名为claude_desktop_config.json的配置文件，并根据以下示例，在此文件的“mcpServers”部分添加设置：

{
  "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应用

保存对claude_desktop_config.json所做的更改后，关闭并重新启动Claude Desktop应用。有时即使看起来已经退出，应用仍可能在后台运行，因此请右键点击驻留图标并选择“退出”。

使用方法

1. 功能验证

首先询问Claude：“查找kintone应用‘可由设置的kintone用户访问的应用名称示例’的应用ID。” 这里输入的kintone应用名称需要完全准确。

2. 此MCP服务器提供的功能列表

关于每个工具的注释属性，请参阅docs/tool-annotations.md。

记录操作

get_record: 获取kintone应用的一个记录
search_records: 搜索kintone应用的记录
create_record: 在kintone应用中创建新记录
update_record: 更新kintone应用的现有记录
upsert_record: 根据kintone应用的唯一字段创建或更新记录（Upsert操作）
add_record_comment: 向kintone记录添加评论
update_record_status: 更新kintone记录的状态（流程管理）
update_record_assignees: 更新kintone记录的操作员（流程管理）
get_record_comments: 获取kintone记录的评论
update_record_comment: 更新kintone记录的现有评论

文件操作

upload_file: 将文件上传到kintone
download_file: 从kintone下载文件（注意：当前实现中，超过1MB的文件可能无法正常下载）

应用信息

get_apps_info: 通过应用名称（字符串搜索）、应用ID（自然数）、应用代码、空间ID组合获取kintone应用信息（app_name 或 app_id 必须提供）
get_form_layout: 获取kintone应用的表单布局
get_form_fields: 获取kintone应用的表单字段信息（仅适用于生产环境，预览环境使用 get_preview_form_fields）
get_app_actions: 获取kintone应用的动作设置
get_app_plugins: 获取添加到kintone应用的插件列表
get_process_management: 获取kintone应用的流程管理设置
get_app_acl: 获取kintone应用的访问权限
get_field_acl: 获取kintone应用字段的访问权限
get_record_acl: 获取指定记录的访问权限
evaluate_records_acl: 根据指定条件评估记录的访问权限
get_views: 获取kintone应用的视图设置
get_reports: 获取kintone应用的图表设置
get_notifications: 获取kintone应用的通知条件设置
get_per_record_notifications: 获取kintone应用的每条记录的通知设置
get_reminder_notifications: 获取kintone应用的提醒通知设置

应用操作

create_app: 创建新的kintone应用
add_fields: 向kintone应用添加字段
update_field: 更新现有的kintone字段设置
update_form_layout: 更改kintone应用的表单布局
update_app_settings: 更新应用的一般设置
deploy_app: 开始kintone应用的生产部署（反映到生产环境）
get_deploy_status: 查看应用设置在生产环境中的反映状态
move_app_to_space: 将kintone应用移动到指定的空间
move_app_from_space: 将kintone应用从空间中移除
update_app_acl: 更新kintone应用的访问权限
update_field_acl: 更新kintone应用字段的访问权限
update_views: 更新kintone应用的视图设置
update_reports: 更新kintone应用的图表设置
update_notifications: 更新kintone应用的通知条件设置
update_per_record_notifications: 更新kintone应用的每条记录的通知设置
update_reminder_notifications: 更新kintone应用的提醒通知设置
update_process_management: 更新kintone应用的流程管理设置
update_app_actions: 更新kintone应用的动作设置

空间操作

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: 获取kintone的用户信息
get_groups: 获取kintone的组信息
get_group_users: 获取指定组的用户列表

kintone连接信息

get_kintone_domain: 获取kintone的连接域名
get_kintone_username: 获取用于连接kintone的用户名

其他

我在博客上写了一些关于如何使用这个MCP服务器的文章，您可以阅读一下。

此外，我们还公开了一个支持OAuth的远程MCP服务器示例代码，可以在Web浏览器版的Claude或ChatGPT中使用。详情请参见这里。

“kintone”是Cybozu株式会社的注册商标。

请注意，这里提供的信息仅供参考，不提供具体的支持。对于设置内容的问题或因个人环境导致的功能失效等问题，我们将无法提供帮助，敬请谅解。