市场连接器MCP
MCP服务器可加速亚马逊、eBay和乐天的电子商务市场连接器开发。
每个服务器都对特定于市场的知识（身份验证流、速率限制、端点怪癖、错误代码）进行编码，这样开发人员代理就可以直接使用它，而无需阅读原始文档。
建筑
servers/
├── marketplace_api/ ← live: API specs, auth, rate limits, endpoints, error codes
├── schema_mapping/ ← live: field mapping, canonical models, transformer code generation
├── codegen/ ← planned: connector scaffolding and code generation
├── testing/ ← planned: test generation and sandbox interaction
└── compliance/ ← planned: marketplace listing rules and validation需求
- Python 3.12+
- 紫外线 （推荐）或pip
设置
1.克隆
git clone
cd marketplace-connectors-mcp2.安装依赖项
uv sync这将安装固定的确切版本 uv.lock --保证在任何机器上都能再现。
3.配置凭据
cp .env.example .env打开 .env 并填写您所在市场的凭证。服务器在没有凭据的情况下工作——只有当连接器代码在运行时调用市场API时才需要凭据。
看 .env.example 查看完整列表以及在何处获取每个凭证。
4.运行服务器
开发模式 （使用MCP检查器UI）：
uv run mcp dev servers/marketplace_api/server.py
uv run mcp dev servers/schema_mapping/server.py生产/标准模式 （克劳德桌面和克劳德代码使用）：
uv run marketplace-api-server
uv run schema-mapping-server______________________________________________________________________
连接到克劳德
克劳德代码（CLI）
注册服务器一次：
claude mcp add marketplace-api -- uv --directory /absolute/path/to/marketplace-connectors-mcp run marketplace-api-server验证：
claude mcp list克劳德桌面
添加到您的Claude Desktop配置文件中：
| 操作系统 | 配置路径 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| 窗户 | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
看 mcp_config.example.json 以添加确切的块。
______________________________________________________________________
可用工具
| 工具 | 说明 |
|---|---|
list_supported_marketplaces() | 列出可用市场 |
get_api_spec(marketplace) | API样式、组、基本URL、常用gotchas |
get_auth_config(marketplace) | 身份验证方案、令牌流、所需的环境变量、沙盒详细信息 |
list_endpoints(marketplace, category) | 带有参数、分页和使用说明的端点 |
get_rate_limits(marketplace, endpoint?) | 速率限制表和限制/重试策略 |
get_error_codes(marketplace, http_status?) | 带有可重试标志和建议操作的错误代码 |
分类 list_endpoints: orders · catalog · inventory · fulfillment · reports · returns
可用提示
| 提示 | 描述 |
|---|---|
connector_kickoff(marketplace) | 结构化发现序列——在编写任何代码之前运行 |
auth_implementation_guide(marketplace) | 认证模块规范，包括令牌刷新和边缘情况 |
rate_limit_strategy(marketplace) | 设计HTTP客户端速率限制器和重试逻辑 |
______________________________________________________________________
项目结构
.
├── .env.example # Credential template — copy to .env
├── mcp_config.example.json # Claude Desktop / Claude Code MCP config
├── pyproject.toml # Project metadata and dependencies
├── uv.lock # Pinned dependency versions
└── servers/
└── marketplace_api/
├── server.py # FastMCP server (tools, resources, prompts)
├── specs/ # High-level API overviews per marketplace
└── fixtures/ # Detailed reference data per marketplace
├── amazon/ (auth | rate_limits | error_codes | endpoints)
├── ebay/
└── rakuten/