FIWARE MCP サーバー
これは、Context Brokerと他のサービス間のブリッジを提供するFIWARE Model Context Protocol (MCP) Serverの最初の実装です。このサーバーは、FIWARE Context Brokerと対話するための基本的な操作を実装しています。
目的
- FIWARE 用の基本的な MCP サーバー実装を作成する
- Context Brokerとのやりとりのためのシンプルなツールを提供する
- Context Broker を使用した基本的な CRUD 操作のデモンストレーション
- より複雑なMCP実装の基盤として機能する
特徴
- Context Brokerのバージョンチェック
- Context Brokerのクエリ機能
- エンティティの公開と更新
前提条件
- Python 3.7以上
- pip (Python パッケージインストーラー)
- FIWARE Context Brokerインスタンスへのアクセス
インストール
- このリポジトリをクローンします:
git clone <repository-url>
cd FIWARE_MCP_01
- 必要な依存関係をインストールします。
pip install -r requirements.txt
クロードデスクトップ統合
mcp install server.py
# Custom name
mcp install server.py --name "FIWARE MCP Server"
# Environment variables, if any
mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
mcp install server.py -f .env
使用法
MCP サーバーを起動します。
python server.py
# or
mcp run server.py
デフォルトでは、サーバーは127.0.0.1:5001で起動します。
利用可能なツール
- CB_バージョン
- Context Brokerのバージョンを確認します
- デフォルトのパラメータ: address="localhost", port=1026
- 戻り値: バージョン情報を含むJSON文字列
- クエリ_CB
- コンテキストブローカーにクエリを実行する
- パラメータ:
- アドレス（デフォルト: "localhost"）
- ポート（デフォルト: 1026）
- クエリ（デフォルト: ""）
- 戻り値: クエリ結果を含むJSON文字列
- CBに公開
- Context Broker 内のエンティティを公開または更新します
- パラメータ:
- アドレス（デフォルト: "localhost"）
- ポート（デフォルト: 1026）
- entity_data (必須: エンティティ情報を含む辞書)
- 戻り値: 操作ステータスを含むJSON文字列
使用例
# Example entity data
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"
}
# Publish to Context Broker
result = publish_to_CB(entity_data=entity_data)
構成
server.pyの次のパラメータを変更することでサーバーを構成できます。
エラー処理
サーバーには、次の包括的なエラー処理が含まれています。
- ネットワーク接続の問題
- コンテキストブローカーからの無効な応答
- 不正なエンティティデータ
- サーバーのシャットダウン
貢献
問題や機能強化のリクエストをお気軽にお寄せください。
ライセンス
このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。