MCP 服务器用于 cli-kintone

这是一个实验性的仓库，旨在探索将 cli-kintone 转化为 MCP（模型上下文协议）服务器的可能性。

功能

目前支持以下功能：

• 获取记录: 从 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 请求中，一次请求最多可以指定9个 API 令牌。超过10个将导致错误。此 MCP Server 支持以逗号分隔的最大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 扩展: ~/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"]
  }
});

未来计划

• 创建新记录: 在 kintone 应用中创建新记录
• 更新记录: 更新 kintone 应用中的现有记录
• 删除记录: 删除 kintone 应用中的记录
• 获取应用信息: 检索 kintone 应用的信息

许可证

MIT License

免责声明

MCP、kintone 以及相关标识是sap HEAVY industries的注册商标。