Fledge 模型上下文协议 (MCP) 服务器

简介

Fledge-MCP 是一个基于 WebSocket 的 JSON-RPC 2.0 实现，用于连接模型和 Fledge 平台。它允许模型通过标准接口与 Fledge 进行交互。

先决条件

• Docker 已安装
• Smithery.ai 账户
• Smithery CLI 工具已安装

安装

方式一：从源码编译

1. 克隆仓库：

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

2. 编译并运行：

npm install
node index.js

方式二：使用 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"
}

错误代码

• -32700: 解析错误
• -32600: 无效请求
• -32601: 方法未找到
• -32602: 参数无效
• -32000: 服务器错误

如需进一步帮助，请参考 Fledge-MCP 文档 或加入我们的 开发者社区。