Clover MCP（モデルコンテキストプロトコル）サーバー

OAuth 認証を使用して Clover API と対話するための最小限の MCP サーバー。

概要

このMCPサーバーにより、生成AIモデルやその他のクライアントは、モデルコンテキストプロトコルを使用してClover加盟店データにアクセスできます。この統合により、モデルは以下のことが可能になります。

• 販売者情報を取得する
• 在庫品目を一覧表示する
• リスト注文
• 個々の商品や注文にアクセスする

クイックスタート

Claude AIと併用（推奨）

1. これを Claude MCP 設定 (通常は~/.config/anthropic/claude.mcp.json内) に追加します。

2. クロードと一緒に使用してください:

3. Claude との会話で OAuth フローを開始します。

コマンドラインからの使用

MCP サーバーを直接実行できます。

Clover OAuth セットアップ

この MCP サーバーを使用する前に、Clover アプリを設定する必要があります。

1. developer.clover.comで Clover 開発者アカウントを作成します。
2. Clover開発者ダッシュボードに新しいアプリを登録する
3. アプリを次のように構成します。
   • サイト URL: http://localhost:4000/oauth-callback
   • デフォルトのOAuthレスポンス: Code
4. クライアントIDとクライアントシークレットをメモしてください
5. これらの資格情報を環境または.envファイルに追加します

MCPツール

MCP プロトコル経由で利用できるツールは次のとおりです。

• get_oauth_status : OAuth 認証情報が利用可能かどうかを確認する
• initiate_oauth_flow : アクセストークンを取得するための OAuth フローを開始する
• get_merchant_info : 販売者に関する情報を取得する
• list_inventory : オプションのフィルターを使用して在庫アイテムを一覧表示する
• list_orders : オプションのフィルターを使用して注文を一覧表示する

クロードとの使用例

以下は、接続後に Claude で使用できるプロンプトの例です。

1. クローバーに接続:
   I'd like to connect to my Clover account.
2. 販売者情報を取得する:
   What information do you have about my Clover merchant account?
3. 在庫品目一覧:
   Show me the first 10 items in my inventory.
4. リスト注文:
   Can you list my most recent orders?

発達

ローカルインストール

1. このリポジトリをクローンする
2. 依存関係をインストールします:
   npm install
3. OAuth 資格情報を設定します。
   cp .env.example .env # Edit .env with your Clover OAuth credentials
4. TypeScript コードをビルドします。
   npm run build
5. MCP サーバーを起動します。
   ./run.sh

出版の更新

新しいバージョンを npm に公開するには:

トラブルシューティング

OAuth の問題が発生した場合:

1. Cloverアプリが正しく登録されていることを確認してください
2. アプリ設定のサイトURLがhttp://localhost:4000/oauth-callbackに設定されていることを確認してください。
3. クライアントIDとクライアントシークレットが正しいことを確認してください
4. 開発者ダッシュボードで「デフォルトのOAuthレスポンス」が「コード」に設定されていることを確認してください。
5. OAuthフローを再度initiate_oauth_flowで開始してみます

ライセンス

マサチューセッツ工科大学