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

Integrations