Ziwei Ai

ZiweiAI MCP 服务

中文说明见 README.zh-CN.md。

用于获取 ZiweiAI 报告的 MCP（Model Context Protocol）服务。可在 Cursor、Claude Desktop 或其他 MCP 客户端中使用，用于列出报告、获取润色后的报告内容以及获取付款链接。

代码库： https://github.com/Timmy9527/agentziwei

安装

选项 A——使用已发布的 npm 软件包（推荐）：

npm install ziweiai-mcp-server

也可直接运行，无需安装（需要 Node.js ≥18）：

npx ziweiai-mcp-server

选项 B——从源代码构建（克隆代码库）：

cd mcp-server
npm install
npm run build

前置条件

1. MCP API 密钥：登录 ziweiai.com 或 ziweiai.com.cn，前往 我的报告，找到 MCP Integration，然后点击 生成 MCP API 密钥。复制密钥（它只会显示一次）。
2. 报告：请先在网站购买报告；MCP 只能列出已购买的报告并获取其内容。

环境变量

变量	必填	说明
ZIWEIAI_MCP_API_KEY	是	网站提供的 MCP API 密钥。
ZIWEIAI_API_BASE	否	API 基础 URL（默认值：https://ziweiai.com）。如果你的账户或报告位于中国站，请使用 https://ziweiai.com.cn。

运行

如果通过 npm 安装：

export ZIWEIAI_MCP_API_KEY="your-key-here"
npx ziweiai-mcp-server

也可使用全局可执行文件（运行 npm install -g ziweiai-mcp-server 后）：

export ZIWEIAI_MCP_API_KEY="your-key-here"
ziweiai-mcp

如果从源代码构建：

export ZIWEIAI_MCP_API_KEY="your-key-here"
node dist/index.js

也可使用 tsx 运行（无需构建）：ZIWEIAI_MCP_API_KEY="your-key" npx tsx src/index.ts

Cursor 配置

添加到 Cursor MCP 设置中（例如 ~/.cursor/mcp.json 或 Cursor 设置 → 功能 → MCP）：

使用 npm 软件包（推荐）：

{
  "mcpServers": {
    "ziweiai": {
      "command": "npx",
      "args": ["-y", "ziweiai-mcp-server"],
      "env": {
        "ZIWEIAI_MCP_API_KEY": "your-mcp-api-key"
      }
    }
  }
}

-y 会让 npx 使用该软件包而不提示。将 your-mcp-api-key 替换为你的密钥。

使用本地构建（请先克隆代码库）：

{
  "mcpServers": {
    "ziweiai": {
      "command": "node",
      "args": ["/path/to/ziweiai/mcp-server/dist/index.js"],
      "env": {
        "ZIWEIAI_MCP_API_KEY": "your-mcp-api-key"
      }
    }
  }
}

将 /path/to/ziweiai 替换为实际路径。

工具

• list_my_reports – 列出已购买的报告（消费者列表）。
• list_report_types – 列出报告类型代码（ming、ln、lc、ll、lr、cp、dh）。
• get_report_content – 获取润色后的报告内容（传入生成参数和 language）。
• get_payment_link – 获取在网站购买报告的 URL（查询参数：paper）。

报告列表 API（GET/POST /api/mcp/reports）

• 身份验证：在请求头 X-MCP-API-Key 中提供你的 MCP API 密钥。
• 查询参数（可选）：format=human（返回便于阅读的字段）；lang=zh 或 lang=en（当 format=human 时，默认值为 en）。不设置 format 时，API 返回原始数组。
• 当 format=human 时，每个项目都包含 reportType、queryInfo、reportPath（语义与网站的“我的报告”页面相同）。原始数据中的 binddate 是拼接后的字符串；无效或空值会安全处理，不会导致错误。

付款

付款始终在网站上完成。MCP 仅列出已购买的报告、返回这些报告的润色内容，并为你尚未购买的报告类型提供付款链接。