wop-mcp

# wop-mcp **万联易达开放平台（WOP）MCP Server —— 让 AI 助手安全、正确地完成 WOP 对接** [](https://www.python.org/downloads/) [](LICENSE) [](https://modelcontextprotocol.io/) []() ## 简介 `wop-mcp` 是万联易达开放平台（WOP）的 [Model Context Protocol](https://modelcontextprotocol.io/) Server， 帮助开发者通过 AI 助手（Claude Desktop、Cursor、Claude Code 等）完成 WOP 对接： - 📚 **文档获取**：接入指南、API 索引、接口详情（自动穿透文档 URL 的时间戳后缀） - 🔐 **密钥对生成**：RSA2048 / SM2，公钥按分发契约编码返回，可直接上报平台 - 🛡️ **安全纪律**：私钥只写入本地 0600 文件，**永不回显进 AI 对话**（对齐 [wop-skills](https://github.com/wop-platform/wop-skills) SECURITY 纪律） - 🔌 **即插即用**：stdio transport，`uvx wop-mcp`（PyPI 发布后）一行接入 ## 工具总览 | 工具 | 说明 | |---|---| | `wop_overview()` | 接入指南（三步流程、securityReq 组合、公钥编码、SDK 列表）+ 实时 `llms.txt` API 索引 | | `wop_api_detail(api)` | API 详情；入参支持 API 路径（如 `/staffing/open/v1/invoice/apply`，可带 POST 前缀、支持省略业务域前缀的后缀匹配）、接口中文名（如 `转账提交`）、完整 `.md` URL | | `wop_link_detail(url)` | 文档中心任意子页 / 外链内容（相对路径自动拼接基址，如 `llms-full.txt`） | | `wop_gen_key_pair(algorithm)` | `RSA2048`（别名 `RSA`）或 `SM2`；返回 `publicKey`（契约编码）+ `privateKeyFile`（0600 路径） | ## 快速开始 ### 方式一：uvx 直接运行（PyPI 发布后） ```bash uvx wop-mcp ``` ### 方式二：源码运行 ```bash git clone https://github.com/wop-platform/wop-mcp.git cd wop-mcp uv sync uv run wop-mcp ``` ## 在 AI 工具中配置 ### Cursor ```json { "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` ```json { "mcpServers": { "wop-mcp": { "command": "uvx", "args": ["wop-mcp"] } } } ``` 源码方式将 `comman…