MCP Server Cli Kintone Experimental

🚀 MCP 服務器用於 cli - kintone

本項目是一個實驗性倉庫，旨在探索將 cli - kintone 轉化為 MCP（模型上下文協議）服務器的可能性，為相關應用提供支持。

🚀 快速開始

本項目可實現從 kintone 應用中檢索記錄的功能。以下為你詳細介紹如何進行安裝和使用。

✨ 主要特性

目前，該項目支持以下功能：

• 獲取記錄：可從 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 的註冊商標。