kintone MCP Server

官方

kintone 官方本地 MCP 服务器，用于管理应用、记录和空间

分类: 数据库第 35 / 58
Stars: ★ 58 热门
传输方式: stdio（本地进程）
运行环境: Docker · Node.js
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 2 天前
工具数: 26

53FMRS · D

kintone MCP Server 是 Cybozu 官方维护的开源（Apache-2.0）本地 MCP 服务器，通过 kintone REST API 提供应用、字段、表单、记录、空间等约 25 个管理工具，支持 MCPB、Docker、npm 三种安装方式及多种认证方式，但不支持访客空间，且明确不在官方 API 支持范围内，问题需通过 GitHub Issues 处理。

最强项 · 文档质量 15/20 最弱项 · 安全与权限 3/20

可靠性

8/20

安全与权限

3/20

维护活跃度

14/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README展示了CI徽章和npm版本徽章，暗示存在自动化构建/发布流程，且提供了25个工具的功能列表，描述与kintone REST API的常见操作（获取/新增/更新/删除应用、记录、空间等）逻辑自洽，未见自相矛盾之处。但本次审查未获得实际的服务器清单（manifest未缓存）、CI工作流文件内容或测试代码，无法验证工具的输入输出模式、错误处理机制或MCP初始化/工具列表握手的真实行为，一切仅停留在文档声称层面。按静态审查校准规则，没有可核实的执行证据（真实CI工作流+已提交测试覆盖关键路径），可靠性不得超过12分；由于缺乏任何可验证的测试或错误处理细节，进一步下调至8分。
安全与权限 3/20: 该服务器暴露了大量不可逆的高风险操作，包括kintone-delete-records（批量删除记录）、kintone-delete-space（删除空间）、kintone-delete-form-fields（删除字段）以及kintone-deploy-app（将应用设置反映到生产/运营环境）。README全文（安装、配置、工具列表、限制、故障排查）中没有任何迹象表明服务器本身在执行这些破坏性操作前会要求二次确认、提供dry-run模式或其他安全阀，安全边界完全依赖调用方（AI客户端/用户）自觉判断。这符合红线标准中的'不可逆删除/部署默认无确认'情形。此外，凭证通过命令行参数或环境变量传递（用户名/密码、API令牌、客户端证书密码），命令行参数方式存在凭证可能出现在进程列表中的常见风险，文档也未说明日志脱敏措施。基于红线判定，安全分数评为3分，并在此处明确标注该红线问题。
维护活跃度 14/20: 本仓库为kintone（Cybozu）官方维护的本地MCP服务器，具有清晰的所有权归属；README中包含CI徽章、npm包版本徽章、Apache-2.0许可证、CONTRIBUTING.md贡献指南入口以及通过GitHub Issues接收缺陷报告和功能请求的渠道，'支持方针'一节也明确说明了该项目不在kintone官方API支持工单范围内、需通过Issues反馈的治理方式。这些迹象表明项目处于持续维护状态且定位明确。但README中未展示具体的版本发布记录、变更日志、发布节奏或依赖更新策略等细节，也没有独立的安全响应渠道说明，治理和版本管理方面存在一定空白，因此评为14分，而非满分。
文档质量 15/20: 文档结构较为完整：提供了三种安装方式（MCPB插件、Docker镜像、npm全局安装）及对应操作步骤、MCP客户端配置文件示例、配置选项一览表（含命令行参数与环境变量的对应关系、是否必填、优先级说明）、独立的认证配置指南链接、完整的25个工具清单（含中文简要说明）、使用注意事项、若干限制事项（如不支持附件字段登记、不支持来宾空间）以及连接/认证/权限三类故障排查建议，并附有隐私政策引用。不足之处在于：工具列表仅给出名称与一句话描述，缺乏每个工具具体的输入参数、返回结构或调用示例（如JSON Schema或调用样例），也未说明各操作对应的API调用成本、频率限制或速率限制信息。综合来看文档可用性较好但存在细节缺口，评为15分。
安装易用性 13/20: 安装路径清晰且覆盖主流场景：Claude Desktop可通过拖拽MCPB包一键安装并在图形界面填写认证信息；Docker和npm方式均提供了可直接复制运行的命令行示例；并给出了标准MCP客户端（如Claude Code、Cursor）的配置文件路径与JSON配置示例，同时说明了代理环境下的HTTPS_PROXY设置方法。整体步骤简明、平台兼容性（Docker/npm/MCPB）覆盖较广。但根据静态审查校准规则，由于本次审查未能获得可验证的实际执行证据（例如实际运行日志或集成测试通过记录），安装易用性不得超过15分；同时文档中未展示实际运行成功的第一手证据，仅为流程性说明，因此评为13分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络

适合谁

已在使用 kintone 平台并希望通过 AI 助手操作应用与记录的团队
需要批量维护 kintone 字段、表单或常规设置的管理员
希望用自然语言驱动 kintone REST API 操作的开发者

不适合谁

未使用 kintone 平台的用户
需要访问 kintone 访客空间（guest space）内应用的场景（不支持）
需要在记录中直接指定附件字段内容的批量导入场景（不支持）

所需权限

kintone 登录用户名和密码，或 API 令牌（最多 9 个，逗号分隔）
可选的 Basic 认证用户名和密码
可选的客户端证书（PFX 文件及密码），用于安全访问域名
对应用的具体访问权限取决于所用账号/令牌被授予的『查看』『新增』『编辑』『删除』等 kintone 权限

风险与副作用

该服务器可直接调用 kintone REST API 增删改记录、字段和应用设置，操作错误可能导致业务数据丢失或应用配置被破坏
凭据（密码、API 令牌、客户端证书密码）通过命令行参数或环境变量传递，需妥善保管配置文件与环境变量，避免泄露
不支持访客空间应用，若业务依赖访客空间可能出现权限或访问异常
官方声明该服务器不在 kintone API 官方支持窗口范围内，出现问题需通过 GitHub Issues 反馈

安装接入

准备工作

运行环境：Docker · Node.js

KINTONE_BASE_URL 必填 kintone 环境的基地址（如 https://example.cybozu.com），由你的 kintone 域名决定，必填。

KINTONE_PASSWORD 可选密钥 kintone 登录密码，与用户名配合使用，属敏感信息。

KINTONE_API_TOKEN 可选密钥在 kintone 应用的设置中生成的 API 令牌，最多可逗号分隔指定 9 个，可替代密码认证。

KINTONE_BASIC_AUTH_PASSWORD 可选密钥 kintone 环境启用了 Basic 认证时的密码，可选。

KINTONE_PFX_FILE_PASSWORD 可选密钥 PFX 证书文件的密码，可选。

其他可选配置项（5 个）

KINTONE_USERNAME 可选 kintone 登录用户名，与密码认证二选一（或使用 API token）。

KINTONE_BASIC_AUTH_USERNAME 可选 kintone 环境启用了 Basic 认证时的用户名，可选。

KINTONE_PFX_FILE_PATH 可选客户端证书认证所用的 PFX 文件路径，可选（域名需为 .s.cybozu.com）。

HTTPS_PROXY 可选企业代理环境的 HTTPS 代理 URL（如 http://proxy.example.com:8080），可选。

KINTONE_ATTACHMENTS_DIR 可选 kintone-download-file 下载文件的保存目录，未指定时该工具会报错。

1) MCPB 方式：从 GitHub Releases 下载 kintone-mcp-server.mcpb，拖入 Claude Desktop「扩展程序」页面安装，并在弹出的配置对话框中填写 kintone 的 Base URL、用户名和密码。2) Docker 方式：需先安装 Docker，执行 docker run -i --rm -e KINTONE_BASE_URL=... -e KINTONE_USERNAME=... -e KINTONE_PASSWORD=... ghcr.io/kintone/mcp-server，或在客户端的 mcp.json 中配置 stdio 命令。3) npm 方式：npm install -g @kintone/mcp-server 后运行 kintone-mcp-server --base-url ... --username ... --password ...（也可用对应环境变量）。

claude_desktop_config.json

{"mcpServers":{"kintone":{"type":"stdio","command":"docker","args":["run","-i","--rm","-e","KINTONE_BASE_URL","-e","KINTONE_USERNAME","-e","KINTONE_PASSWORD","ghcr.io/kintone/mcp-server:latest"],"cwd":"${cwd}","env":{"KINTONE_BASE_URL":"https://example.cybozu.com","KINTONE_USERNAME":"username","KINTONE_PASSWORD":"password"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "kintone": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KINTONE_BASE_URL",
        "-e",
        "KINTONE_USERNAME",
        "-e",
        "KINTONE_PASSWORD",
        "ghcr.io/kintone/mcp-server:latest"
      ],
      "cwd": "${cwd}",
      "env": {
        "KINTONE_BASE_URL": "https://example.cybozu.com",
        "KINTONE_USERNAME": "username",
        "KINTONE_PASSWORD": "password"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add kintone -e KINTONE_BASE_URL=https://example.cybozu.com -e KINTONE_USERNAME=username -e KINTONE_PASSWORD=password -- docker run -i --rm -e KINTONE_BASE_URL -e KINTONE_USERNAME -e KINTONE_PASSWORD ghcr.io/kintone/mcp-server:latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动服务器后，在客户端的工具列表中应出现 kintone-get-apps 等工具；输入「列出我的 kintone 应用」并返回应用列表即证明连接成功。

常见排障

连接错误：检查 Base URL 是否正确（如 https://example.cybozu.com），如处于代理环境需设置 HTTPS_PROXY 环境变量，短暂无法连接可稍后重试
认证错误：核对用户名密码是否正确；不要同时指定用户名密码与 API 令牌，同时指定时密码认证优先；使用客户端证书时确认域名为安全访问域名（如 .s.cybozu.com）
权限错误：确认所用用户或 API 令牌对目标应用具备相应权限（应用管理权限或记录查看权限等）；确认目标应用不在访客空间内；使用 API 令牌时确认已授予所需的『查看』『新增』『编辑』『删除』权限
使用 kintone-download-file 工具前，必须通过 --attachments-dir 或 KINTONE_ATTACHMENTS_DIR 指定保存目录，否则执行会报错；若目录不存在会自动创建

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 kintone 环境中的所有应用。
读取应用 10 的表单字段配置，然后添加一个名为「备注」的单行文本字段。
查询应用 20 中今天创建的记录，并为每条记录添加评论。
下载记录 5 中附件字段的文件并保存到本地。

工具能力 26

kintone-get-apps 只读

获取多个应用的信息

kintone-get-app 只读

获取单个应用的详细信息

kintone-get-form-fields 只读

获取应用的字段设置

kintone-get-form-layout 只读

获取应用的表单布局

kintone-update-form-fields 写入

更新应用的字段设置

kintone-update-form-layout 写入

更新应用的表单布局

kintone-delete-form-fields 破坏性

删除应用的字段

kintone-get-process-management 只读

获取流程管理设置

展开其余 18 个工具

kintone-get-app-deploy-status 只读

确认应用设置向正式环境的反映状态

kintone-get-general-settings 只读

获取应用的常规设置

kintone-add-form-fields 写入

向应用添加字段

kintone-get-records 只读

获取多条记录

kintone-add-records 写入

添加多条记录

kintone-update-records 写入

更新多条记录

kintone-delete-records 破坏性

删除多条记录

kintone-update-statuses 写入

更新多条记录的状态

kintone-get-record-comments 只读

获取记录的评论

kintone-add-record-comment 写入

向记录添加评论

kintone-add-app 写入

在测试环境中创建应用

kintone-deploy-app 写入

将应用设置反映到正式环境

kintone-update-general-settings 写入

更改应用的常规设置

kintone-download-file 写入

保存附件字段中的文件

kintone-add-space-from-template 写入

根据模板创建空间

kintone-update-space 写入

更新空间设置

kintone-get-space 只读

获取空间信息

kintone-delete-space 破坏性

删除空间

使用场景

让 AI 助手查询和汇总 kintone 应用中的记录数据

批量新增、更新或删除 kintone 记录

管理 kintone 应用的字段、表单布局及常规设置

将应用配置从测试环境部署到正式环境

创建和管理 kintone 空间及记录评论

支持客户端

Claude Desktop

Claude Code部分支持

Cursor部分支持

依据项目文档列出，未经本站实测。

详细介绍

由 Cybozu 官方维护的 kintone 本地 MCP 服务器，通过 kintone REST API 连接。提供应用与表单管理、记录的增删改查、流程管理、空间管理及附件下载等能力。支持通过 MCPB 包（Claude Desktop 扩展）、Docker 镜像或 npm 包三种方式安装，可使用用户名密码、API 令牌、Basic 认证或客户端证书进行身份验证。