MCP Server Cli Kintone Experimental

🚀 cli-kintone用MCPサーバー

このリポジトリは、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サーバーは、カンマ区切りで最大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の登録商標です。