Kintone Deno MCP Server

🚀 Denoを使用したkintone MCPサーバーの実装例

このプロジェクトは、kintone（サイボウズのクラウド型業務アプリケーション）とのやり取りを目的としたモデルコンテキストプロトコル(MCP)サーバーをDeno環境で動作させるサンプルを提供します。Denoを使用することで、通信を許可するkintoneドメインを制限することができ、セキュリティ上の懸念を軽減します。

🚀 クイックスタート

1. ソースコードのダウンロード

ソースコードは任意の場所にダウンロードできますが、半角英数字のみで空白を含まないパスに配置することをおすすめします。

2. Denoのインストール（推奨バージョン：v1.40以上）

公式ガイドの手順に従ってDenoをインストールしてください。

3. Denoサーバーの起動

プロジェクトディレクトリで以下のコマンドを実行します。

export KINTONE_DOMAIN=dev-demo.cybozu.com
export KINTONE_USERNAME=demo-guest
export KINTONE_PASSWORD=demo-guest
deno task start

⚠️ 重要提示

初回実行時には、npmパッケージの使用を許可するかどうかのメッセージが表示される場合があります。この場合は、--allow-envと--allow-netの権限を付与する必要があります。

4. Claude Desktopアプリケーションの設定

claude_desktop_config.jsonという名前の設定ファイルを見つけ、以下の例を参考に、mcpServersセクションに関連設定を追加します。

{
  "mcpServers": {
    "kintone": {
      "command": "deno",
      "env": {
        "KINTONE_DOMAIN": "[使用するサブドメイン].cybozu.com",
        "KINTONE_USERNAME": "MCP接続に使用するkintoneユーザー名",
        "KINTONE_PASSWORD": "kintoneユーザーのパスワード（平文）"
      },
      "args": [
        "run",
        "--allow-env",
        "--allow-net=[使用するサブドメイン].cybozu.com",
        "[kintone-deno-mcp-serverを配置したパス]/server.js"
      ]
    }
  }
}

5. Claude Desktopアプリケーションの再起動

claude_desktop_config.jsonファイルの変更を保存した後、Claude Desktopアプリケーションを終了して再起動します。アプリケーションがバックグラウンドで実行されている場合は、アイコンを右クリックして「Quit」を選択して完全に閉じてください。

6. 機能テスト

まず、Claudeに「MCP接続ユーザーがアクセスできるkintoneアプリケーション名とそれに対応するアプリケーションIDを検索する」と問い合わせてください。kintoneアプリケーション名を正確に指定する必要があり、些細な違いでもエラーが発生する可能性があります。

⚠️ 注意事項

「kintone」はCybozu Inc.の登録商標です。

以上の内容は参考情報として提供されており、具体的なサポートサービスは提供されていません。個人の環境設定によっては正常に動作しない場合があり、当プロジェクトでは一切の責任を負いません。