Rivalize MCP Server已验证已精选

什么是 Rivalize MCP Server？

Rivalize MCP Server 将 Claude、Cursor 等 MCP 客户端连接到竞争情报平台 Rivalize，让你的助手获取有来源、有日期的竞品拆解、定价、广告、评价、招聘和增长势头数据，而不是凭模型记忆作答。

它是一个本地 stdio 服务器，以 @rivalize/mcp 发布在 npm 上（MIT 许可，由 Downshift LLC 开发）。它是 Rivalize API 的轻量客户端：每次工具调用都会携带你的 API 密钥，向 rivalize.ai 发起一次 HTTPS 请求。服务器默认只读，仅有一个需主动开启的写入工具。

如何使用 Rivalize MCP Server？

前提条件：

1. Node.js 22 或更高版本（node --version）。
2. 一个 rivalize.ai 账号。
3. 在 Dashboard → Settings → API Keys 中创建的 API 密钥。密钥以 rk_live_ 开头。任何套餐的密钥都可用，包括免费套餐（读取会被限速）。

Claude Code

claude mcp add rivalize -e RIVALIZE_API_KEY=rk_live_... -- npx -y @rivalize/mcp

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），然后重启 Claude Desktop：

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Cursor

将同样的 mcpServers 配置块添加到项目中的 .cursor/mcp.json，或添加到 ~/.cursor/mcp.json 以用于所有项目。

VS Code

VS Code 在 .vscode/mcp.json 中使用 servers 键：

{
  "servers": {
    "rivalize": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

其他客户端与 Docker

任何 stdio 客户端都可以用参数 -y @rivalize/mcp 和环境变量 RIVALIZE_API_KEY 启动 npx。在 Windows 上，部分客户端无法直接启动 npx.cmd，此时把命令设为 cmd，参数设为 /c npx -y @rivalize/mcp。仓库还提供了 Dockerfile（docker build -t rivalize-mcp .），用 docker run -i --rm -e RIVALIZE_API_KEY rivalize-mcp 运行。

可选环境变量：RIVALIZE_MCP_ALLOW_WRITES=1 注册写入工具；RIVALIZE_API_URL 指向自托管或非生产环境的 Rivalize 服务器；HTTPS_PROXY/HTTP_PROXY 让请求经由公司代理。

Rivalize MCP Server 的主要功能

• 一次调用完成拆解：针对任意竞品域名，给出定位、定价、广告、社交、评价、招聘、增长势头和可攻击的弱点，并注明数据最近一次刷新的时间。
• 公司数据库：搜索 Rivalize 跨客户追踪的公司数据集，查看包含定价、功能、融资、招聘、排名和信号的完整档案。
• 你自己的账号：读取你的项目、报告、追踪的竞品、battlecard、战略时间线和竞争格局。
• 来源与新鲜度：每条事实都能追溯到来源 URL 和读取日期；被报告的捏造检查移除的说法会显示为 [removed — unverified]。
• 默认只读：唯一的写入工具 add_competitor 只有在你主动开启后才会出现在客户端中。
• 响应长度受控：每个响应都不超过 25,000 个字符，通过明确的分页、偏移量以及 _capped/_omitted 标记处理，而不是悄悄截断。
• 无遥测：服务器不在本地存储任何内容，数据只发送到 Rivalize API（或你的代理）。

Rivalize MCP Server 工具

始终可用的只读工具共 13 个：

• 拆解与公司数据库：teardown_competitor 为某个 domain 返回 Markdown 格式的战略拆解；list_universe_companies 和 get_universe_company 用于搜索 Rivalize 数据库中的公司并查看其档案。
• 项目与报告：list_projects 返回其他工具需要的 project_id；list_reports 和 get_report 可按整份、按章节（如 pricing、battlecards、actions）、按竞品或按页读取报告。读取不会生成新报告。
• 追踪的竞品：list_competitors、get_competitor_intelligence 和 get_battlecard（需 Pro 套餐）覆盖你追踪的对手。
• 随时间的变化：get_strategic_timeline 展示 30、90 或 180 天内定价、产品、人员、融资和内容方面附带证据的动向；get_competitive_landscape 展示当前或每周的格局位置。
• 可信度：get_freshness 显示每个竞品最近一次被观测的时间，get_evidence 列出事实背后的来源。

设置 RIVALIZE_MCP_ALLOW_WRITES 后，add_competitor 可向项目添加最多 10 个竞品 URL，这会消耗额度并排队进行分析。

Rivalize MCP Server 的使用场景

• 快速拆解：“Tear down linear.app.”
• 市场版图：“AI 开发者工具领域有哪些玩家？”
• 定价复盘：“总结我最新的报告，然后告诉我竞品的收费情况。”
• 季度动向：“本季度哪些竞品动作最大，他们做了什么？”
• 销售准备：“给我一些针对头号竞品的销售话术。”
• 事实核查：“这个定价说法来自哪里，数据有多新？”

Rivalize MCP Server 常见问题排查

• 客户端显示 “Connection closed”：服务器会在 stderr 的第一行打印原因，前缀为 rivalize-mcp:。常见原因是缺少密钥或密钥不以 rk_live_ 开头、客户端自身 PATH 中的 Node.js 低于 22，或无法联网（在代理环境下设置 HTTPS_PROXY）。
• 在终端中测试：运行 RIVALIZE_API_KEY=rk_live_... npx -y @rivalize/mcp。正常的服务器会打印 rivalize-mcp-server connected via stdio 并等待输入。
• 每次调用都返回 401：密钥已被撤销或被拒绝。除非密钥由其他 Rivalize 服务器签发，否则不要设置 RIVALIZE_API_URL。
• 提示“需要更高套餐”：所有套餐都可读取，但 battlecard 以及完整的时间线或格局历史需要更高套餐；错误信息会附上定价页链接。