FIWARE MCP Server

🚀 FIWARE MCP サーバー

このサーバーは、FIWARE モデルコンテキストプロトコル (MCP) の初期実装で、コンテキストエージェントとその他のサービス間の橋渡しを行います。FIWARE コンテキストエージェントとの基本的なやり取りを実現しています。

🚀 クイックスタート

このセクションでは、FIWARE MCP サーバーの基本的な使い方を説明します。まずは、必要な環境をセットアップし、サーバーを起動しましょう。

✨ 主な機能

• コンテキストエージェントのバージョンチェック
• コンテキストエージェントの機能クエリ
• エンティティの公開と更新

📦 インストール

前提条件

• Python 3.7 以上
• pip（Python パッケージインストーラー）
• FIWARE コンテキストエージェントインスタンスへのアクセス権

インストール手順

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

git clone <repository-url>
cd FIWARE_MCP_01

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

pip install -r requirements.txt

Claude デスクトップ統合

mcp install server.py

# カスタム名
mcp install server.py --name "FIWARE MCP サーバー"

# 環境変数（必要な場合）
mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
mcp install server.py -f .env

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

python server.py
# または
mcp run server.py

サーバーはデフォルトで 127.0.0.1:5001 で実行されます。

利用可能なツール

1. CB_version

   • コンテキストエージェントのバージョンを確認します。
   • デフォルトパラメータ：address="localhost"，port=1026
   • 戻り値：バージョン情報を含む JSON 文字列

2. query_CB

   • コンテキストエージェントをクエリします。
   • パラメータ：
     • address（デフォルト: "localhost"）
     • port（デフォルト: 1026）
     • query（デフォルト: ""）
   • 戻り値：クエリ結果の JSON 文字列

3. publish_to_CB

   • コンテキストエージェント内のエンティティを公開または更新します。
   • パラメータ：
     • address（デフォルト: "localhost"）
     • port（デフォルト: 1026）
     • entity_data（必須: エンティティ情報を含む辞書）
   • 戻り値：操作状態の JSON 文字列

高度な使用法

# エンティティデータの例
entity_data = {
    "id": "urn:ngsi-ld:TemperatureSensor:001",
    "type": "TemperatureSensor",
    "temperature": {
        "type": "Property",
        "value": 25.5
    },
    "@context": "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
}

# コンテキストエージェントに公開
result = publish_to_CB(entity_data=entity_data)

📚 ドキュメント

設定

server.py 内の以下のパラメータを変更することで、サーバーを設定できます。

• ホストアドレス
• ポート番号
• タイムアウト設定

エラー処理

サーバーには包括的なエラー処理機能が備わっており、以下の問題を処理します。

• ネットワーク接続問題
• コンテキストエージェントからの有効な応答
• エンティティデータの形式が正しくない
• サーバーの停止

📄 ライセンス

このプロジェクトは、Apache License 2.0 の下でライセンスされています。

貢献

問題の報告や機能強化のリクエストはいつでも歓迎です！