VOC OpenAPI MCP

VOC OpenAPI MCP 安装程序

English | 简体中文

安装完整的 VOC OpenAPI MCP 服务，为 Amazon 评论洞察、反馈标注、商品信息优化以及数百种已发布的数据工具提供支持，可用于本地 AI 客户端。

专为电商运营人员、消费者洞察团队、产品研究人员以及需要授权评论数据和可重复 VOC 工作流的 AI Agent 打造。

用法

curl -fsSL https://open.voc.ai/install.sh | bash

默认情况下，安装程序会在浏览器中打开 VOC 登录页面并请求访问授权。 授权后，安装程序会自动为检测到的受支持客户端写入 MCP 配置， 包括 Codex、Claude、Cursor 以及下方列出的其他客户端。

Windows PowerShell：

irm https://open.voc.ai/install.ps1 | iex

或者，直接使用 npm 包：

npx voc-openapi-mcp@latest setup

Codex 用户也可以安装通用的 VOC OpenAPI 查询技能：

npx voc-openapi-mcp@latest setup --with-skill

只有检测到 Codex 时，技能才会写入 ~/.agents/skills/voc-openapi/SKILL.md。卸载程序只会移除由安装程序管理且未经用户修改的版本。

默认情况下，安装程序会注册在本地计算机上检测到的 Agent。目前支持：

• Claude Code（CLI；写入 ~/.claude.json）
• Claude Desktop（桌面应用；检测 macOS 应用或 Windows %LOCALAPPDATA%\AnthropicClaude，写入 claude_desktop_config.json，并通过 mcp-remote 桥接远程 MCP 服务）
• Cursor（桌面应用或 CLI 启动器；检测 macOS 应用或 Windows %LOCALAPPDATA%\Programs\cursor，二者均使用 ~/.cursor/mcp.json）
• Windsurf（桌面应用或 CLI 启动器；检测 macOS 应用或 Windows %LOCALAPPDATA%\Programs\Windsurf，二者均使用 ~/.codeium/windsurf/mcp_config.json）
• WorkBuddy（桌面应用；写入用户级 ~/.workbuddy/mcp.json）
• Gemini CLI（写入 ~/.gemini/settings.json）
• Codex（CLI 和桌面应用均使用 ~/.codex/config.toml）

列出在本地计算机上检测到的 Agent：

curl -fsSL https://open.voc.ai/install.sh | bash -s -- --list-agents

Windows PowerShell：

& ([scriptblock]::Create((irm https://open.voc.ai/install.ps1))) -ListAgents

注册所有受支持的 Agent（默认情况下，安装程序会自动检测已安装的客户端，因此通常无需执行此操作）：

npx voc-openapi-mcp@latest setup --all-agents

默认配置：

• Codex：$CODEX_HOME/config.toml，如果未设置 CODEX_HOME，则使用 ~/.codex/config.toml
• Claude Code：~/.claude.json
• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）
• Cursor：~/.cursor/mcp.json
• Windsurf：~/.codeium/windsurf/mcp_config.json
• WorkBuddy：~/.workbuddy/mcp.json
• Gemini CLI：~/.gemini/settings.json
• MCP 服务名称：voc-openapi
• MCP URL：https://open.voc.ai/mcp-server
• 身份验证标头：X-API-Key
• 完整端点：所有已发布的 VOC OpenAPI MCP 工具
• Codex MCP 启动超时：120 秒

安装程序会就地更新相应的 MCP 服务配置，不会创建 .bak 备份文件。

选项

voc-mcp setup \
  --api-base https://open.voc.ai \
  --name voc-openapi \
  --with-skill \
  --config ~/.codex/config.toml

身份验证

默认且推荐的流程是通过浏览器登录。安装程序会在默认浏览器中打开 VOC 授权页面，等待你登录并批准访问，然后自动更新检测到的 AI 客户端。如果无法 打开浏览器，安装程序会显示相同的授权 URL，你可以手动打开。你无需将浏览器中的 凭据复制回终端。

API Key 替代方式

你也可以跳过浏览器授权，直接提供 API Key：

VOC_OPENAPI_API_KEY=voc_live_sk_xxx npx voc-openapi-mcp@latest setup

请妥善保管 API Key：不要将其提交到代码库、粘贴到问题反馈或聊天中，也不要将其包含在 截图和日志中。优先使用上方的环境变量，而不是将 Key 直接写入共享命令或脚本。

预览

npx voc-openapi-mcp@latest setup --api-key voc_live_sk_xxx --dry-run

注意： 为支持一键设置，目前 API Key 会以明文形式存储在本地 MCP 客户端配置文件中。

用于目录扫描器的本地 stdio 服务

Glama 等目录扫描器主要使用仓库中的 Dockerfile 来构建并启动精简的本地 stdio MCP 服务以进行评估。从源代码克隆或 Docker 镜像启动时，服务命令为：

node bin/voc-mcp.js serve

发布 npm 包后，对应的包命令为：

npx voc-openapi-mcp@latest serve

此模式通过 tools/list 暴露相同的七个精选工具，以供目录检查和基于 Docker 的评估。实际的 tools/call 请求需要 VOC_OPENAPI_API_KEY、VOC_API_KEY 或 X_API_KEY；如果未提供密钥，服务会明确返回需要 API 密钥的错误，而不会伪造业务结果。生产环境用户应继续使用托管端点 https://open.voc.ai/mcp/catalog。

示例结果

这条 Agent 请求汇总了商品和商品信息数据、评论洞察、客户痛点、竞争定位以及建议措施。点击图片可查看完整结果。

功能

• 获取当前或历史 Amazon 评论。
• 分析情感、痛点和主题。
• 根据客户反馈生成商品信息改进建议。
• 将反馈和商品信息标记到结构化分类体系中。

有关全部七个工具、输入字段、积分成本以及创建任务的副作用，请参阅 TOOLS.md。

隐私、权限与支持

托管服务仅接收所选工具的输入，以及授权 VOC 账户所需的 X-API-Key。安装程序只会写入所选 AI 客户端的 MCP 配置和可选的 VOC 技能。安装前请查看 PRIVACY.md 和 SECURITY.md。

• 产品网站
• 隐私政策
• 条款和条件
• 支持
• 官方 Registry 元数据

许可证

安装程序源代码采用 Apache License 2.0 许可。 托管的 VOC OpenAPI 服务及其业务功能仍受 VOC 条款和条件约束。