MCP Gs Robot

🚀 Gausium OpenAPI MCPサーバー

このプロジェクトは、MCP（モデル制御プロトコル）サーバーを実装しています。これはGausium OpenAPIとの橋渡しとして機能し、AIモデルやその他のクライアントが標準化されたインターフェースを通じてガウシアンロボットとやり取りできるようにします。

リポジトリ：https://github.com/cfrs2005/mcp-gs-robot

🚀 クイックスタート

このサーバーを使用することで、AIモデルやクライアントは標準化されたインターフェースを通じてガウシアンロボットと交互することができます。以下に、サーバーのセットアップと実行の手順を示します。

✨ 主な機能

現在のサーバーは、MCPツールとして以下の機能をサポートしています。

• list_robots：APIキーを通じてアクセス可能なロボットをリストします。 (ベース: ロボット一覧API)
• get_robot_status：シリアル番号を指定して特定のロボットの詳細な状態を取得します。(ベース: ロボット状態取得API)
• list_robot_task_reports：時間でフィルタリングして、特定のロボットのタスクレポートを取得します。(ベース: ロボットタスクレポート一覧API)
• list_robot_maps：特定のロボットのマップ一覧を取得します。(ベース: ロボットマップ一覧API)

🔧 技術詳細

アーキテクチャ

サーバーはレイヤードアーキテクチャに従っており、関心事を分離し、保守性を向上させています。

MCPプロトコルフロー

下図は、AIモデルがMCPプロトコルを通じてガウシアンロボットとどのようにやり取りするかを示しています。

プロジェクト構造

コードディレクトリのレイアウトは次の通りです。

src/
├── gs_openapi/
│   ├── config.py
│   ├── client.py
│   └── tools/
│       ├── list_robots.py
│       ├── get_robot_status.py
│       ├── list_robot_task_reports.py
│       └── list_robot_maps.py
└── main.py

📦 インストール

環境要件

• Python 3.6+

依存関係のインストール

pip install python-sseclient requests

実行手順

1. リポジトリをクローンします。

   git clone https://github.com/cfrs2005/mcp-gs-robot.git
   cd mcp-gs-robot
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. 環境変数を設定します（ターミナルで）。

   export GS_CLIENT_ID="your_client_id"
   export GS_CLIENT_SECRET="your_client_secret"
   export GS_OPEN_ACCESS_KEY="your_access_key"
   

4. サーバーを起動します。

   python main.py
   

   デフォルトでは、このコマンドはSSEトランスポートを使用したサーバーを起動し、http://0.0.0.0:8000にバインドされます。main.pyでトランスポートタイプをstdioに変更することができます。

📚 ドキュメント

プロジェクトに関する説明

• GS_CLIENT_ID：あなたのGausiumアプリケーションのクライアントIDです。
• GS_CLIENT_SECRET：あなたのGausiumアプリケーションのクライアントシークレットです。
• GS_OPEN_ACCESS_KEY：あなたのGausium OpenAPIのアクセスキーです。

資格情報をコードにハードコードしないでください。また、バージョン管理システムにそれらをコミットしないでください。

MCPクライアントの接続

サーバーが起動した後、MCPクライアント（Cursorやその他の互換性のあるツールなど）は適切なトランスポートプロトコル（SSEまたはstdio）を通じてこのサーバーに接続し、定義されたツールを使用することができます。

使用例：Cursorとの連携

下図は、CursorがこのMCPサーバーとどのようにやり取りするかの例です。

デバッグ

サーバーのログを監視することでデバッグを行うことができます。main.pyの基本的なログ設定では、タイムスタンプ、レベル、およびソース情報が提供されます。

以下は、サーバーが実行中のときのログ出力の例です。