1nce MCP Server

🚀 1NCE IoT 平臺 MCP 服務器

本項目是一個模型上下文協議 (MCP) 服務器，能讓人工智能代理藉助自然語言與 1NCE 物聯網連接管理平臺進行交互，極大地簡化了物聯網設備連接管理的流程。

🚀 快速開始

該項目提供了一層中間件，把大型語言模型 (LLMs) 連接到 1NCE API，用於管理物聯網連接。AI 助手可通過它獲取產品信息、管理訂單、監控 SIM 卡狀態等，藉助 Model Context Protocol 功能，AI 代理能用自然語言與物聯網基礎架構交互，簡化了連接設備的管理。

✨ 主要特性

• 身份驗證：基於 OAuth 2.0 令牌的安全身份驗證，使用 1NCE API。
• 產品管理：可查詢可用的物聯網連接產品。
• 訂單管理：支持創建和跟蹤訂單。
• SIM 管理：能監控和配置 SIM 卡。
• 資源：可直接訪問 SIM 狀態和產品數據。
• 提示：提供用於常見任務的預定義交互模板。

📦 安裝指南

先決條件

• Python 3.8+
• FastMCP v2
• 帶有 API 憑證的 1NCE 賬戶

安裝步驟

1. 克隆此倉庫

git clone https://github.com/yourusername/1nce-mcp-server.git
cd 1nce-mcp-server

2. 安裝所需的依賴項

pip install fastmcp httpx

3. 設置環境變量，使用你的 1NCE API 憑證

export ONCE_CLIENT_ID="your_client_id"
export ONCE_CLIENT_SECRET="your_client_secret"

💻 使用示例

使用 FastMCP 安裝

推薦使用 FastMCP CLI 安裝此 MCP 服務器：

fastmcp install 1nce_mcp.py

這將使服務器對兼容的 MCP 客戶端可用，包括 Claude Desktop。

直接運行

在開發或測試時，可以直接運行服務器：

python 1nce_mcp.py

使用客戶端

你可以使用 FastMCP 客戶端與服務器進行程序化交互：

from fastmcp import Client

async with Client("1nce_mcp.py") as client:
    # 獲取所有產品列表
    products = await client.call_tool("get_all_products")
    print(products)
    
    # 檢查 SIM 狀態
    sim_status = await client.call_tool("get_sim_status", {"iccid": "your_sim_iccid"})
    print(sim_status)

可用工具

產品工具

• get_all_products() - 獲取所有可用的 1NCE 產品

訂單工具

• get_all_orders(page, page_size, sort) - 使用分頁獲取訂單列表
• get_order_by_number(order_number) - 獲取特定訂單的詳細信息
• create_order(products, delivery_address, customer_reference) - 創建新訂單

SIM 工具

• get_all_sims(page, page_size, query, sort) - 列出 SIM 卡，帶過濾選項
• get_sim_details(iccid) - 獲取特定 SIM 的詳細信息
• get_sim_status(iccid) - 檢查 SIM 的連接狀態
• get_sim_data_quota(iccid) - 檢查 SIM 剩餘數據配額