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 剩余数据配额