FIWARE MCP サーバー

これは、Context Brokerと他のサービス間のブリッジを提供するFIWARE Model Context Protocol (MCP) Serverの最初の実装です。このサーバーは、FIWARE Context Brokerと対話するための基本的な操作を実装しています。

目的

• FIWARE 用の基本的な MCP サーバー実装を作成する

• Context Brokerとのやりとりのためのシンプルなツールを提供する

• Context Broker を使用した基本的な CRUD 操作のデモンストレーション

• より複雑なMCP実装の基盤として機能する

Related MCP server: Synapse MCP Server

特徴

• Context Brokerのバージョンチェック

• Context Brokerのクエリ機能

• エンティティの公開と更新

前提条件

• Python 3.7以上

• pip (Python パッケージインストーラー)

• FIWARE Context Brokerインスタンスへのアクセス

インストール

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

git clone <repository-url>
cd FIWARE_MCP_01

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

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で起動します。

利用可能なツール

1. CB_バージョン

   • Context Brokerのバージョンを確認します

   • デフォルトのパラメータ: address="localhost", port=1026

   • 戻り値: バージョン情報を含むJSON文字列

2. クエリ_CB

   • コンテキストブローカーにクエリを実行する

   • パラメータ:

     • アドレス（デフォルト: "localhost"）

     • ポート（デフォルト: 1026）

     • クエリ（デフォルト: ""）

   • 戻り値: クエリ結果を含むJSON文字列

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