mcp-computeflux

mcp-computeflux

零依赖的 MCP（Model Context Protocol）服务。为任意 MCP 主机——Cursor、Claude Desktop、Windsurf 或任意 MCP 客户端——提供一个兼容 OpenAI 的端点，并将 ComputeFlux 上的模型作为普通工具调用：先列出可用模型，再运行聊天补全。

你的 MCP Agent 可通过一个兼容 OpenAI 的端点调用闪存级模型。

• 约 175 行 Node 18+ 代码，运行服务无需 npm install（只有可选的 client/ 端到端测试脚手架需要安装 SDK 依赖）。
• 不依赖特定后端：可将其指向任意兼容 OpenAI 的 API——ComputeFlux 是默认目标，但不是唯一目标。
• ComputeFlux 是一个兼容 OpenAI、可通过 TEE 验证的多模型推理网关，部署在 Polkadot 测试网上。

工具

工具	功能
computeflux_models	列出端点提供的模型 ID。
computeflux_chat	运行非流式聊天补全（model + OpenAI 的 messages；可选 max_tokens、temperature）。返回模型、结束原因、延迟、用量和助手文本。

配置（环境变量）

变量	必需	默认值	备注
COMPUTEFLUX_API_KEY	是	—	端点的 Bearer 密钥。
COMPUTEFLUX_BASE_URL	否	https://api.computeflux.ai/v1	任意兼容 OpenAI 的基础 URL。

export COMPUTEFLUX_API_KEY="your_c***_key"
# export COMPUTEFLUX_BASE_URL="https://your-openai-compat-host/v1"   # optional

安装

已发布到官方 MCP Registry（.mcpb 包，无需 npm 步骤）：

io.github.computeflux2026isgod/mcp-computeflux — 已列入官方 MCP Registry（按此名称搜索）。

任何支持从注册表安装的 MCP 客户端 / Agent（mcp add、Cursor、Claude Desktop、Claude Code）都可以按名称获取。直接克隆 Git 仓库的快速入门：

git clone https://github.com/computeflux2026isgod/mcp-computeflux
export COMPUTEFLUX_API_KEY="your_...key"
node /path/to/mcp-computeflux/server.mjs   # stdio JSON-RPC

mcpServers 片段：

{
  "mcpServers": {
    "computeflux": {
      "command": "node",
      "args": ["/path/to/mcp-computeflux/server.mjs"],
      "env": { "COMPUTEFLUX_API_KEY": "your_c***_key" }
    }
  }
}

本地端到端测试（可选）

client/ 包含一个使用官方 MCP SDK 的小型测试脚手架——与 Cursor / Claude Desktop 使用的路径完全一致。它通过 stdio 启动服务、列出工具，并运行一次聊天补全，同时检查唯一令牌的往返保真度。

cd client && npm install && npm run e2e   # expects COMPUTEFLUX_API_KEY in the .env it points to

传输

通过 stdio 传输以换行符分隔的 JSON-RPC 2.0。标准输出仅写入协议消息；日志写入标准错误。

许可证

MIT