wop-mcp

万联易达开放平台（WOP）MCP Server —— 让 AI 助手安全、正确地完成 WOP 对接

简介

wop-mcp 是万联易达开放平台（WOP）的 Model Context Protocol Server， 帮助开发者通过 AI 助手（Claude Desktop、Cursor、Claude Code 等）完成 WOP 对接：

• 📚 文档获取：接入指南、API 索引、接口详情（自动穿透文档 URL 的时间戳后缀）
• 🔐 密钥对生成：RSA2048 / SM2，公钥按分发契约编码返回，可直接上报平台
• 🛡️ 安全纪律：私钥只写入本地 0600 文件，永不回显进 AI 对话（对齐 wop-skills SECURITY 纪律）
• 🔌 即插即用：stdio transport，uvx wop-mcp（PyPI 发布后）一行接入

工具总览

快速开始

方式一：uvx 直接运行（PyPI 发布后）

uvx wop-mcp

方式二：源码运行

git clone https://github.com/wop-platform/wop-mcp.git
cd wop-mcp
uv sync
uv run wop-mcp

在 AI 工具中配置

Cursor

{
  "mcpServers": {
    "wop-mcp": {
      "command": "uvx",
      "args": ["wop-mcp"],
      "timeout": 600,
      "autoApprove": ["wop_overview", "wop_api_detail", "wop_link_detail"]
    }
  }
}

Claude Desktop

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wop-mcp": {
      "command": "uvx",
      "args": ["wop-mcp"]
    }
  }
}

源码方式将 command/args 替换为：

{
  "command": "uv",
  "args": ["--directory", "/path/to/wop-mcp", "run", "wop-mcp"]
}

wop_gen_key_pair 写本地私钥文件，建议保留人工确认（未列入 autoApprove）。

环境变量

安全纪律

• 私钥只落盘不回显：wop_gen_key_pair 返回值不含任何私钥材料；私钥以 0600 权限独占创建于 WOP_KEYS_DIR。
• 公钥即上报格式：RSA = X.509 SPKI DER 的 Base64；SM2 = 未压缩点 04‖X‖Y（65 字节）的 Base64（crypto-strategy-spec §3.4，D10/D12）。
• 契约自检：每次生成后经 wop-python-sdk 官方加载器回读（含 SM2 曲线校验），编码不合约即报错。
• keys/ 目录已入 .gitignore，严禁将私钥文件提交入库或粘贴进对话。

算法说明（与 spec 的差异）

本工具密钥生成支持 RSA2048 / SM2。crypto-strategy-spec v0.4 草案的 securityReq 国际族档位为 RSA3072/RSA4096；平台实际接受的 RSA 档位以商户中心审核为准。 国密族与国际族禁止跨族组合。

开发

uv sync                          # 安装依赖（含 dev 组）
uv run pytest --cov=wop_mcp --cov-fail-under=95   # 测试 + 覆盖率门禁
npm i -g lefthook && lefthook install             # 激活 git 钩子（commitlint + 覆盖率门禁）

• 提交信息遵循 Conventional Commits（commitlint 校验）
• CI：GitHub Actions，Python 3.10–3.13 矩阵，覆盖率红线 95%

许可证

MIT © 2026 wop-platform