用于 cli-kintone 的 MCP 服务器

这是一个实验性的仓库，其想法是验证是否可以将 cli-kintone 转换为 MCP (Model Context Protocol) 服务器。

功能

目前，支持以下功能：

• get_records: 从 kintone 应用程序获取记录

安装

# 克隆仓库
git clone https://github.com/r3-yamauchi/mcp-server-cli-kintone-experimental.git
cd mcp-server-cli-kintone-experimental

# 安装依赖
npm install

# 构建
npm run clean:lib && npm run build:mcp

使い方 (使用方法)

1. MCP 配置文件创建

使用用户名和密码进行身份验证：

{
  "mcpServers": {
    "kintonecli": {
      "command": "node",
      "args": ["/path/to/mcp-server-cli-kintone/start-mcp-server.mjs"],
      "env": {
        "KINTONE_DOMAIN": "your-domain.cybozu.com",
        "KINTONE_USERNAME": "username",
        "KINTONE_PASSWORD": "password"
      }
    }
  }
}

使用 API 令牌进行身份验证：

{
  "mcpServers": {
    "kintonecli": {
      "command": "node",
      "args": ["/path/to/mcp-server-cli-kintone/start-mcp-server.mjs"],
      "env": {
        "KINTONE_DOMAIN": "your-domain.cybozu.com",
        "KINTONE_API_TOKEN": "your-api-token1,your-api-token2,your-api-token3"
      }
    }
  }
}

2. 关于 API 令牌的限制

在 kintone 的 API 请求中，一次请求中可以指定的 API 令牌数量最多为 9 个。 指定 10 个或更多个将导致错误。 此 MCP 服务器最多可以接受 9 个以逗号分隔的 API 令牌。 请注意，如果指定了 10 个或更多个 API 令牌，将会发生错误。

KINTONE_API_TOKEN="token1,token2,token3,token4,token5,token6,token7,token8,token9"

3. MCP 配置文件放置

• Claude Desktop App: ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

4. 从 AI 助手使用

可以从 AI 助手调用工具，如下所示：

use_mcp_tool({
  server_name: "kintonecli",
  tool_name: "get_records",
  arguments: {
    app: "应用ID",
    query: "创建日期 > \"2025-01-01\"",
    fields: ["字段1", "字段2"]
  }
});

或者，也可以直接指定域名和 API 令牌：

use_mcp_tool({
  server_name: "kintonecli",
  tool_name: "get_records",
  arguments: {
    domain: "your-domain.cybozu.com",
    apiToken: "your-api-token1,your-api-token2,your-api-token3",
    app: "应用ID",
    query: "创建日期 > \"2025-01-01\"",
    fields: ["字段1", "字段2"]
  }
});

今后的扩展计划

• create_record: 创建新记录
• update_record: 更新现有记录
• search_apps: 按应用程序名称搜索
• import_records: 导入多个记录
• delete_record: 删除单个记录
• bulk_update_records: 更新多个记录
• bulk_delete_records: 删除多个记录

许可证

MIT

“kintone”是 Cybozu Co., Ltd. 的注册商标。

此处包含的内容仅用于提供信息，我们无法提供个人支持。 请理解，即使您提出有关设置内容的问题或在您自己的环境中无法运行的问题，我们也无法提供支持。