Fledge MCP

🚀 Fledge モデルコンテキストプロトコル (MCP) サーバー

Fledge-MCP は、WebSocket ベースの JSON-RPC 2.0 の実装で、モデルと Fledge プラットフォームを接続するために使用されます。標準インターフェースを通じて、モデルが Fledge と相互作用できるようにします。

🚀 クイックスタート

Fledge-MCP は、WebSocket を利用した JSON-RPC 2.0 の実装で、モデルと Fledge プラットフォームを接続するために設計されています。これにより、モデルは標準的なインターフェースを通じて Fledge と相互作用することができます。

✨ 主な機能

• WebSocket ベースの JSON-RPC 2.0 実装を通じて、モデルと Fledge プラットフォームを接続します。
• 標準インターフェースを介して、モデルが Fledge と相互作用できるようにします。

📦 インストール

前提条件

• Docker がインストールされていること
• Smithery.ai アカウントを持っていること
• Smithery CLI ツールがインストールされていること

インストール方法

方法1：ソースコードからコンパイル

1. リポジトリをクローンします：

git clone https://github.com/fledge-mcp/fledge-mcp-server.git
cd fledge-mcp-server

2. コンパイルして実行します：

npm install
node index.js

方法2：Docker イメージを使用する

docker pull fledge/mcp-server
docker run -it --rm fledge/mcp-server

💻 使用例

基本的な使用法

サーバーの起動

デフォルトでは、サーバーは 8082 ポートを監視します。

コマンドライン引数

• -p: API ポートを指定します。デフォルトは 8081 です。
• -H: Fledge ホストアドレスを設定します。デフォルトは localhost です。
• --version: バージョン情報を表示して終了します。
• --help: ヘルプ情報を表示して終了します。

Cursor への接続

接続の初期化

{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {},
    "id": "1"
}

ツールの一覧表示

{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": "2"
}

高度な使用法

利用可能なツール

センサーデータの取得

async getSensorData(sensorId, limit) => {
    // センサーデータを取得するための実装
}

デバイスの状態を照会する

async getDeviceStatus(deviceId) => {
    // デバイスの状態を照会するための実装
}

API のテスト

テスト依存関係のインストール

npm install -D npm-run-scripts

テストの実行

npm test

📚 ドキュメント

本番環境での注意事項

• HTTPS を設定する
• リバースプロキシ（Nginx など）を使用する
• より強力な認証（JWT、OAuth）を実装する
• レート制限を追加する
• 永続的なサブスクリプションストレージを設定する

Smithery.ai へのデプロイ

必要条件

• Docker がインストールされていること
• Smithery.ai アカウントを持っていること
• Smithery CLI ツールがインストールされていること

デプロイ手順

# イメージをビルドする
docker build -t fledge-mcp .

# Smithery にプッシュする
smithery deploy

モニタリングと更新

• リアルタイムログを表示する：smithery logs fledge-mcp
• デプロイを更新する：smithery deploy --update

JSON-RPC プロトコルのサポート

初期化メソッド

{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {},
    "id": "1"
}

ツールリストメソッド

{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": "2"
}

エラーコード

さらなるヘルプが必要な場合は、Fledge-MCP ドキュメント を参照するか、開発者コミュニティ に参加してください。