Fledge IoT

🚀 Fledge MCP 服務器

Fledge MCP 服務器是一個模型上下文協議（MCP）服務器，它能將 Fledge 功能與 Cursor AI 相連接，讓 AI 可以通過自然語言命令與 Fledge 實例進行交互。

🚀 快速開始

若要使用 Fledge MCP 服務器，需滿足以下先決條件：

• 本地安裝了 Fledge 或可通過 API 訪問（默認：http://localhost:8081）
• 安裝了 Cursor AI
• Python 3.8+

📦 安裝指南

1. 克隆此倉庫：

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

2. 安裝依賴項：

pip install -r requirements.txt

💻 使用示例

基礎用法

1. 啟動服務器：

python mcp_server.py

2. 訪問 http://localhost:8082 在瀏覽器中查看文檔。

高級用法

示例請求

1. 初始化：

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

2. 列出工具：

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

3. 調用工具：

{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
        "name": "get_sensor_data",
        "parameters": {
            "sensor_id": "temp1",
            "limit": 10
        }
    },
    "id": "3"
}

JSON - RPC 協議支持

服務器使用 JSON - RPC 2.0 協議實現模型上下文協議（MCP）。

1. initialize

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

   響應：

   {
       "jsonrpc": "2.0",
       "result": {
           "serverInfo": {
               "name": "fledge-mcp",
               "version": "1.0.0"
           }
       },
       "id": "1"
   }
   

✨ 主要特性

• 支持通過 WebSocket 的 JSON - RPC 2.0 協議
• 提供以下工具：
  • 獲取傳感器數據
  • 控制設備
  • 獲取系統狀態
  • 獲取日誌信息
  • 設置報警閾值

🔧 技術細節

錯誤碼

服務器遵循標準的 JSON - RPC 2.0 錯誤碼：

• -32700: 解析錯誤
• -32600: 無效請求
• -32601: 方法未找到
• -32602: 參數無效
• -32000: 服務器錯誤

📚 詳細文檔

生產環境注意事項

• 使用 HTTPS
• 部署在反向代理（如 Nginx）之後
• 實現更強大的身份驗證（JWT、OAuth）
• 添加速率限制
• 設置持久數據存儲用於訂閱

在 Smithery.ai 上部署

1. 先決條件

   • 安裝 Docker
   • Smithery.ai 賬戶
   • 安裝 Smithery CLI 工具

2. 構建和部署

# 構建 Docker 鏡像
docker build -t fledge-mcp .

# 部署到 Smithery.ai
smithery deploy

3. 配置

   • WebSocket 傳輸在 8082 端口
   • 可配置的 Fledge API URL
   • 工具定義和參數
   • 超時設置

4. 環境變量

   • FLEDGE_API_URL: 您的 Fledge API 端點
   • API_KEY: 您的安全模式 API 密鑰

5. 驗證

smithery status fledge-mcp

6. 監控

   • 通過 Smithery.ai 控制檯進行即時日誌、性能指標、錯誤跟蹤和資源使用情況的監控。

7. 更新

# 構建新鏡像
docker build -t fledge-mcp .
   
# 部署更新
smithery deploy --update