FIWARE Context Broker

🚀 FIWARE MCP サーバー

これはFIWARE モデルコンテキストプロトコル（MCP）サーバーの最初の実装です。コンテキストプロキシとその他のサービス間の橋渡しを行い、コンテキストプロキシとの基本的な操作を実装しています。

🚀 クイックスタート

このセクションでは、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

💻 使用例

基本的な使用法

MCP サーバーを起動します：

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 に基づいてライセンスされています。