VOC OpenAPI MCP

io.github.SolveaCX由 GitHub 账号 SolveaCX 发布v1.0.5更新于 Oct 24, 2026

VOC OpenAPI gives AI agents authorized review and product data for insights, tagging, and listings.

已验证Streamable HTTP可网页运行数据与分析商业与电商

概览

AI 生成的概览

VOC OpenAPI MCP 让 AI 助手获取经授权的亚马逊评论与商品数据，用于洞察分析、反馈打标和商品详情优化。

可以做什么
获取商品和商品详情的当前或历史亚马逊评论，并在此基础上做情感、痛点和主题分析。根据客户反馈生成商品详情改进建议。将评论和商品详情归入结构化分类体系。通过托管端点调用已发布的 VOC OpenAPI 数据工具，在一次请求中组合商品、详情、评论和竞争定位数据。
适用场景
适合电商运营、消费者洞察团队和产品研究人员，让助手拉取经授权的亚马逊评论数据，并转化为 VOC 分析、打标或商品详情优化建议。
运行要求
远程 MCP 端点 open.voc.ai，通过 streamable HTTP 访问。需要 VOC 账号及 API 密钥，通过 X-API-Key 请求头发送，可通过浏览器登录获取或直接提供。可选安装器是 npm 包，会为检测到的客户端（如 Claude、Cursor、Codex、Gemini CLI）写入 MCP 配置。
安装前请注意
X-API-Key 会以明文形式保存在本地 MCP 客户端配置文件中，请妥善保密，避免提交到代码库、日志或截图。部分工具会创建任务并消耗额度。托管服务器会接收所选工具的输入和 API 密钥。安装器会就地修改现有客户端配置，且不创建备份文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 VOC OpenAPI MCP，将其添加到工作区。
  2. 连接 X-API-Key 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.SolveaCX%2Fvoc-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "voc-openapi": {
      "type": "http",
      "url": "https://open.voc.ai/mcp/catalog",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

VOC OpenAPI MCP Installer

English | 简体中文

Install the full VOC OpenAPI MCP server for Amazon review insights, feedback tagging, listing optimization, and hundreds of published data tools in local AI clients.

Built for e-commerce operators, consumer-insights teams, product researchers, and AI agents that need authorized review data and repeatable VOC workflows.

Usage

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

By default, the installer opens your browser to sign in to VOC and approve access. After authorization, it automatically writes the MCP configuration for the supported clients detected on your machine, including Codex, Claude, Cursor, and others listed below.

Windows PowerShell:

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

Alternatively, use the npm package directly:

bash
npx voc-openapi-mcp@latest setup

Codex users can also install the general-purpose VOC OpenAPI query skill:

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

The skill is written to ~/.agents/skills/voc-openapi/SKILL.md only when Codex is detected. The uninstaller removes only installer-managed versions that have not been modified by the user.

By default, the installer registers the agents detected on the local machine. It currently supports:

  • Claude Code (CLI; writes to ~/.claude.json)
  • Claude Desktop (desktop app; detects the macOS app or Windows %LOCALAPPDATA%\AnthropicClaude, writes to claude_desktop_config.json, and bridges the remote MCP server through mcp-remote)
  • Cursor (desktop app or CLI launcher; detects the macOS app or Windows %LOCALAPPDATA%\Programs\cursor, both using ~/.cursor/mcp.json)
  • Windsurf (desktop app or CLI launcher; detects the macOS app or Windows %LOCALAPPDATA%\Programs\Windsurf, both using ~/.codeium/windsurf/mcp_config.json)
  • WorkBuddy (desktop app; writes user-level ~/.workbuddy/mcp.json)
  • Gemini CLI (writes to ~/.gemini/settings.json)
  • Codex (CLI and Desktop both use ~/.codex/config.toml)

List the agents detected on the local machine:

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

Windows PowerShell:

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

Register every supported agent (the installer detects installed clients automatically by default, so this is usually unnecessary):

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

Default configuration:

  • Codex: $CODEX_HOME/config.toml, or ~/.codex/config.toml when CODEX_HOME is not set
  • Claude Code: ~/.claude.json
  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (or %APPDATA%\Claude\claude_desktop_config.json on Windows)
  • Cursor: ~/.cursor/mcp.json
  • Windsurf: ~/.codeium/windsurf/mcp_config.json
  • WorkBuddy: ~/.workbuddy/mcp.json
  • Gemini CLI: ~/.gemini/settings.json
  • MCP server name: voc-openapi
  • MCP URL: https://open.voc.ai/mcp-server
  • Authentication header: X-API-Key
  • Full endpoint: all published VOC OpenAPI MCP tools
  • Codex MCP startup timeout: 120 seconds

The installer updates the corresponding MCP server configuration in place and does not create .bak backup files.

Options

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

Authentication

Browser sign-in is the default and recommended flow. The installer opens the VOC authorization page in your default browser, waits for you to sign in and approve access, then updates the detected AI clients automatically. If the browser cannot be opened, the installer prints the same authorization URL so you can open it manually. You do not need to copy a credential from the browser back into the terminal.

API Key alternative

You can also skip browser authorization and provide an API key directly:

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

Keep the API key private: do not commit it, paste it into issues or chat, or include it in screenshots and logs. Prefer the environment variable above over putting the key directly in a shared command or script.

Preview

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

Note: To support a one-command setup, the API key is currently stored as plain text in the local MCP client configuration file.

Local stdio server for catalog scanners

Catalog scanners such as Glama primarily use the repository Dockerfile to build and start a minimal local stdio MCP server for evaluation. From a source clone or Docker image, the server command is:

bash
node bin/voc-mcp.js serve

After the npm package release, the equivalent package command is:

bash
npx voc-openapi-mcp@latest serve

This mode exposes the same seven curated tools through tools/list for catalog introspection and Docker-based evaluation. Real tools/call requests require VOC_OPENAPI_API_KEY, VOC_API_KEY, or X_API_KEY; without a key the server returns an explicit API-key-required error instead of fake business results. Production users should continue to use the hosted endpoint https://open.voc.ai/mcp/catalog.

Example result

[VOC OpenAPI MCP product analysis result covering listing data, review insights, pain points, competitive positioning, and recommended actions]

This single agent request combines product and listing data, review insights, customer pain points, competitive positioning, and recommended actions. Click the image to view the full result.

Capabilities

  • Fetch current or historical Amazon reviews.
  • Analyze sentiment, pain points, and themes.
  • Generate listing improvements from customer feedback.
  • Tag feedback and product listings into structured taxonomies.

See TOOLS.md for all seven tools, input fields, credit costs, and task-creating side effects.

Privacy, permissions, and support

The hosted server only receives the selected tool inputs and the X-API-Key required for the authorized VOC account. The installer writes only the selected AI client's MCP configuration and the optional VOC skill. Review PRIVACY.md and SECURITY.md before installation.

License

The installer source code is licensed under the Apache License 2.0. The hosted VOC OpenAPI service and its business capabilities remain subject to the VOC Terms and Conditions.

来源：README.md，提交 135f87a

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

1
  1. v1.0.5最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分