Dncampo 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 Desktop 統合

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

貢献

問題や改善要求はいつでも提出してください！