易趣API MCP服务器

](https://www.npmjs.com/package/ebay-mcp) ](https://www.npmjs.com/package/ebay-mcp) ![Tests](tests/) ![API Coverage](src/tools/) ![License](LICENSE) ![Contributors Welcome](CONTRIBUTING.md)

](https://mseep.ai/app/yosefhayim-ebay-api-mcp-server)

A. 模型上下文协议（MCP）服务器为AI助手提供对eBay销售API的全面访问。包含 325工具 用于库存管理、订单履行、营销活动、分析、开发工具等。

API覆盖范围： 100%（270个唯一的易趣API端点）

______________________________________________________________________

一键式AI设置

让你的AI助手为你设置这个！ 复制下面的提示并将其粘贴到Claude、ChatGPT或任何支持MCP的AI助手中。

Click to copy the AI setup prompt

I want to set up the eBay MCP Server for my AI assistant. Please help me:

1. Install the eBay MCP server:
   npm install -g ebay-mcp

2. I need to configure it for [Claude Desktop / Cursor / Cline / Zed / Continue.dev / Windsurf / Claude Code CLI / Amazon Q] (choose one)

3. My eBay credentials are:
   - Client ID: [YOUR_CLIENT_ID]
   - Client Secret: [YOUR_CLIENT_SECRET]
   - Environment: [sandbox / production]
   - Redirect URI (RuName): [YOUR_REDIRECT_URI]

Please:
- Create the appropriate config file for my MCP client
- Set up the environment variables
- Help me complete the OAuth flow to get a refresh token for higher rate limits
- Test that the connection works

If I don't have eBay credentials yet, guide me through creating a developer account at https://developer.ebay.com/

______________________________________________________________________

⚠️ 免责声明

重要提示：在使用本软件之前，请仔细阅读本免责声明。

这是一个 开源项目 按“原样”提供，不提供任何明示或暗示的保证。使用本软件即表示您承认并同意以下内容：

无责任： 本项目的作者、贡献者和维护者接受 无责任或义务 因使用本软件而可能产生的任何损坏、损失或问题，包括但不限于：

- 数据丢失或损坏 - 经济损失 - 服务中断 - 易趣账户暂停或终止 - 违反易趣的服务条款或API使用政策 - 任何其他直接或间接损害

易趣API使用： 该项目是一个非官方的第三方实现 不隶属于eBay股份有限公司、由eBay背书或由eBay赞助。 您全权负责：

- 遵守易趣API使用条款 - 确保您的使用量不超过eBay的费率限制和政策 - 安全地管理您的易趣开发者凭据 - 理解并遵守 eBay的数据处理要求 - 通过API执行的任何操作

使用风险自负： 此软件用于教育和开发目的。用户必须：

- 在生产使用之前，在eBay的沙盒环境中进行彻底测试 - 了解代表其进行的API调用 - 维护关键数据的备份 - 监控其API使用情况和帐户状态

安全： 您负责：

- 确保API证书的安全 - 正确配置环境变量 - 了解MCP服务器使用的安全影响 - 遵循安全最佳实践

无保修： 提供此软件时，不保证其功能、可靠性或适用于特定目的。

使用本软件即表示您接受所有风险，并同意保护作者、贡献者和维护者免受任何索赔、损害或责任。

有关易趣API的官方支持，请参阅易趣开发者计划.

______________________________________________________________________

特性

325易趣API工具 -100%覆盖易趣销售API，涵盖库存、订单、营销、分析、开发工具等
支持9个AI客户端 -自动配置Claude Desktop、Cursor、Zed、Cline、Continue.dev、Windsurf、Roo Code、Claude Code CLI和Amazon Q
OAuth 2.0支持 -具有自动刷新功能的完整用户令牌管理
类型安全 -使用TypeScript、Zod验证和OpenAPI生成的类型构建
MCP集成 -STDIO传输，可与AI助手直接集成
智能身份验证 -从用户令牌（10k-50k需求/天）自动回退到客户端凭据（1k需求/天
测试良好 -958+次全面覆盖的测试
交互式安装向导 -快跑 npm run setup 用于在OAuth自动浏览器打开的情况下进行引导配置
开发者分析 -速率限制监控和签名密钥管理

快速开始

1.获取易趣凭据

创建免费易趣开发者帐户
在中生成应用程序密钥开发者门户
保存你的 客户端ID 和 客户端密钥

2.安装

选项A：从npm安装（推荐）

npm install -g ebay-mcp

选项B：从源代码安装

git clone https://github.com/YosefHayim/ebay-mcp.git
cd ebay-mcp
npm install
npm run build

3.运行安装向导

交互式设置向导为您处理所有事情：

npm run setup

内置标准Node CLI提示堆栈，可实现可靠的交互式设置。

向导将：

配置您的易趣凭据
设置OAuth身份验证（用于更高的速率限制）
自动检测和配置您的MCP客户端（Claude Desktop等）
自动保存所有配置

______________________________________________________________________

演示

查看与Claude Desktop配合使用的易趣MCP服务器：

https://github.com/user-attachments/assets/0173c8df-221c-4943-a4ce-cd20bce79f4b

______________________________________________________________________

可视化安装指南

安装向导(npm run setup)自动处理OAuth身份验证。以下是在易趣开发者门户中查找您的凭据的位置：

查找您的凭据

第一步： 引导到易趣开发者门户并复制您的 应用程序ID（客户端ID） 和 证书ID（客户端密码）:

Step 1 - Copy credentials from eBay Developer Portal

第二步： 在您的应用程序中 用户令牌 设置，复制 RuName （易趣重定向URL）：

Step 2 - Copy RuName from eBay Sign-in Settings

运行安装向导

跑 npm run setup 并在提示时输入您的凭据。向导将：

自动打开浏览器进行OAuth登录
引导您完成易趣登录过程

Step 3 - Sign in to eBay during OAuth flow

要求您从回调URL粘贴授权码

Step 4 - Paste authorization code into setup wizard

将代码替换为令牌并自动保存
配置您的MCP客户端（Claude Desktop等）

成功！ 现在，您的用户令牌身份验证每天有10k-50k个请求，而不是默认的1k/天。

______________________________________________________________________

4.使用

重新启动您的MCP客户端（Claude Desktop等），并通过您的AI助手开始使用易趣工具。

配置

📖 有关详细解释所有环境变量、OAuth流程步骤和故障排除的全面配置指南，请参阅配置文档.

环境变量

安装向导(npm run setup)自动创建和配置您的 .env 文件。作为参考，这些是使用的环境变量：

EBAY_CLIENT_ID=your_client_id
EBAY_CLIENT_SECRET=your_client_secret
EBAY_ENVIRONMENT=sandbox  # or "production"
EBAY_REDIRECT_URI=your_runame
EBAY_MARKETPLACE_ID=EBAY_US  # Default marketplace (overridable by many tools)
EBAY_CONTENT_LANGUAGE=en-US  # Default request content language (global)
EBAY_USER_REFRESH_TOKEN=your_refresh_token  # For higher rate limits

OAuth身份验证

客户端凭据（默认）： 每天1000个请求-仅使用客户端ID和密码即可自动工作。

用户令牌（推荐）： 10000-50000个请求/天-安装向导自动处理OAuth流。令牌会自动刷新。

有关详细的OAuth设置和全面的配置指南，请参阅配置文档.

MCP客户端兼容性

此服务器支持 9个AI客户端 通过自动配置 npm run setup:

客户端	平台	配置路径	状态
克劳德桌面	macOS、Windows、Linux	`~/Library/Application Support/Claude/claude_desktop_config.json`	✅ 自动配置
光标IDE	macOS、Windows、Linux	`~/.cursor/mcp.json`	✅ 自动配置
Zed编辑	macOS、Windows、Linux	`~/.config/zed/settings.json`	✅ 自动配置
克莱恩	VSCode扩展	`~/...globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`	✅ 自动配置
Continue.dev	VSCode，JetBrains	`~/.continue/config.json`	✅ 自动配置
风帆冲浪（Codeium）	macOS、Windows、Linux	`~/.codeium/windsurf/mcp_config.json`	✅ 自动配置
Roo代码	VSCode扩展	`~/...globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json`	✅ 自动配置
克劳德代码CLI	航站楼	`~/.claude.json`	✅ 自动配置
亚马逊Q开发者	AWS	`~/.aws/amazonq/mcp.json`	✅ 自动配置

配置要求：

MCP协议版本：1.0+
传输：STDIO（默认）或HTTP
Node.js运行时：18.0.0或更高版本

任何客户端的快速设置：

npm install -g ebay-mcp
npx ebay-mcp setup  # Interactive setup wizard - auto-detects installed clients

安装向导将自动检测您安装了哪些AI客户端，并为您进行配置。

速率限制

了解易趣API费率限制对于生产使用至关重要：

客户端凭据（默认）：

每日限额： 每天1000个请求
最适合： 开发、测试、小批量操作
设置： 仅使用客户端ID和密码自动

用户令牌（推荐）：

每日限额： 每天10000-50000个请求（因账户类型而异）
最适合： 生产、大批量运营
设置： 需要OAuth流（使用 ebay_get_oauth_url 工具）

按账户类型划分的利率限制级别：

个人开发者：10000次请求/天
商业开发商：25000个请求/天
企业：50000+请求/天（自定义限制）

利率限制最佳实践：

将用户令牌用于生产工作负载
对速率限制错误实施指数回退
尽可能缓存响应
在易趣开发者门户中监控您的使用情况
API支持的批处理操作
考虑升级您的开发人员帐户级别以获得更高的限制

处理速率限制：

当您达到速率限制时，API返回429状态代码。服务器将：

使用指数回退自动重试
通知您利率限制错误
建议升级到用户令牌身份验证

检查当前使用情况：

在中监控您的API使用情况易趣开发者门户.

可用工具

服务器提供 325工具 和 API覆盖率100% 分为以下几类：

账户管理 -政策、计划、订阅、销售税
库存管理 -商品、报价、位置、批量操作、SKU位置映射
订单履行 -订单、运输、退款、争议、付款争议证据
营销和促销 -活动、广告、促销、竞价、批量运营
分析 -流量报告、卖家标准、指标
沟通 -买卖双方消息传递、谈判、通知、反馈
元数据和分类 -类别、项目方面、政策
开发者工具 -速率限制、签名密钥、客户端注册
许可证管理 -OAuth URL生成、令牌管理

示例工具：

ebay_get_inventory_items -列出所有库存物品
ebay_get_orders -检索卖家订单
ebay_create_offer -创建新的上市报价
ebay_get_campaigns -获取营销活动
ebay_get_oauth_url -生成OAuth授权URL

有关完整的工具列表，请参阅 src/工具/定义/.

使用示例

以下是您可以使用易趣MCP服务器完成的一些常见任务：

为更高的速率限制设置OAuth

用户： “你能帮我为我的易趣帐户设置OAuth身份验证吗？”

助理： 用途 ebay_get_oauth_url 生成授权URL的工具。您访问该URL，授予权限，助手将帮助您在您的 .env 文件。

结果： 每天访问10000-50000个API请求，而不是1000个。

管理库存

用户： “显示我在易趣上的所有活动物品”

助理： 用途 ebay_get_inventory_items 检索所有库存物品。

结果： 显示所有产品的格式化列表，包括SKU、数量和状态。

处理订单

用户： “获取过去7天内所有未完成的订单”

助理： 用途 ebay_get_orders 带有日期过滤器和履行状态参数。

结果： 返回准备装运处理的待处理订单列表。

创建营销活动

用户： “为我的电子产品类别创建促销活动”

助理： 用途 ebay_create_campaign 以及建立广告活动的相关营销工具。

结果： 使用指定的预算和目标项目创建的新活动。

批量操作

用户： “更新'复古手表'类别中所有商品的价格，享受10%的折扣”

助理： 联合 ebay_get_inventory_items，按类别筛选，并使用 ebay_update_offer 应用批量定价更改。

结果： 所有匹配的商品都更新了新的定价。

发展

先决条件

Node.js>=18.0.0
npm或pnpm
易趣开发者帐户

贡献者快速入门

git clone https://github.com/YOUR_USERNAME/ebay-mcp.git
cd ebay-mcp
npm install
npm run setup      # Interactive setup wizard
npm run build
npm test

命令参考

命令	描述
`npm run build`	将TypeScript编译为JavaScript
`npm start`	运行MCP服务器
`npm run dev`	使用热重新加载运行服务器
`npm test`	运行测试套件
`npm run setup`	交互式设置向导
`npm run sync`	同步规格、生成类型、查找缺少的端点
`npm run diagnose`	检查配置和连接
`npm run check`	运行类型检查+lint+格式检查
`npm run fix`	自动修复棉绒和格式问题

添加新的API端点

当易趣发布新的API端点时，请使用同步工具来识别缺少的内容：

npm run sync

此单个命令将：

从eBay下载最新的OpenAPI规范
根据规范生成TypeScript类型
分析实现了哪些端点
报告缺少需要工具的端点

添加新端点的工作流：

跑 npm run sync 识别缺失的端点
检查 dev-sync-report.json 查看完整列表
在中创建新工具 src/tools/definitions/
在中添加API方法 src/api/
在中编写测试 tests/
跑 npm run check && npm test

项目结构

ebay-mcp/
├── src/
│   ├── index.ts           # MCP server entry point
│   ├── api/               # eBay API implementations
│   ├── auth/              # OAuth & token management
│   ├── tools/             # MCP tool definitions
│   ├── types/             # TypeScript types (auto-generated)
│   ├── scripts/           # CLI tools (setup, sync, diagnose)
│   └── utils/             # Shared utilities
├── docs/                  # OpenAPI specs (auto-downloaded)
├── tests/                 # Test suite
└── build/                 # Compiled output

Docker支持

docker-compose up -d       # Start container
docker-compose logs -f     # View logs
docker-compose down        # Stop container

有关详细的贡献指南，请参阅贡献.md.

贡献

欢迎投稿！以下是如何开始：

分叉存储库
创建要素分支： git checkout -b feature/my-feature
进行更改并添加测试
运行质量检查： npm run check && npm test
使用提交约定式提交
推到叉子上，打开Pull Request

提交前：

确保所有测试通过
遵循TypeScript的最佳实践
根据需要更新文档
保持测试覆盖率

看贡献.md 详细指南。

日志记录

服务器包括基于Winston的日志记录，便于调试。日志输出到stderr（与MCP协议兼容），也可以输出到文件。

日志级别

通过环境变量设置日志级别：

EBAY_LOG_LEVEL=debug  # Options: error, warn, info, http, verbose, debug, silly

文件记录

为持久日志启用文件日志记录：

EBAY_ENABLE_FILE_LOGGING=true

日志文件存储在 ~/.ebay-mcp/logs/:

error.log -仅错误级别消息
combined.log -所有日志消息
debug.log -调试和详细消息

日志输出示例

[2024-01-15 10:30:45] [INFO] [Server] Starting eBay API MCP Server
[2024-01-15 10:30:45] [INFO] [Auth] Loading tokens from environment variables
[2024-01-15 10:30:46] [INFO] [Auth] Access token refreshed successfully
[2024-01-15 10:30:46] [HTTP] [API] Request: GET https://api.ebay.com/sell/inventory/v1/inventory_item
[2024-01-15 10:30:47] [HTTP] [API] Response: 200 OK

______________________________________________________________________

故障排除

常见问题

服务器未出现在Claude桌面中

问题： 易趣MCP服务器未显示在您的MCP客户端中。

解决：

验证配置文件路径是否适用于您的操作系统
检查JSON语法是否有效（使用JSON验证器）
确保环境变量设置正确
完全重新启动克劳德桌面
检查Claude Desktop日志中的错误消息

身份验证错误

问题： “凭据无效”或“身份验证失败”错误。

解决：

验证您的 EBAY_CLIENT_ID 和 EBAY_CLIENT_SECRET 是正确的
确保您使用的是正确的环境（沙盒与生产环境）
检查您的应用程序密钥是否在易趣开发者门户中处于活动状态
对于用户令牌，请验证您的 EBAY_USER_REFRESH_TOKEN 有效
跑 npm run diagnose 检查您的配置

速率限制错误

问题： “超出速率限制”错误。

解决：

升级到用户令牌身份验证（10k-50k请求/天）
在使用中实现请求限制
在开发人员门户中检查您当前的费率限制
考虑升级您的易趣开发者帐户级别

工具工作不正常

问题： 工具返回意外错误或空结果。

解决：

验证您使用的环境是否正确（沙盒与生产环境）
确保您具有操作的适当权限/范围
使用检查当前API状态 ebay_get_api_status 工具或易趣API状态页
跑 npm run diagnose 检查您的配置
查看易趣API文档对于端点要求

诊断工具

运行诊断程序以排除配置问题：

# Interactive diagnostics
npm run diagnose

# Export diagnostic report
npm run diagnose:export

诊断工具检查：

环境变量配置
易趣API连接
身份验证状态
令牌有效性
可用范围和权限

获取帮助

如果您仍然遇到问题：

检查现有
使用以下内容创建新问题：

- 您的诊断报告(npm run diagnose:export) - 重现问题的步骤 - 错误消息或日志 - 您的环境（操作系统、节点版本、MCP客户端）

资源

API状态

查看当前易趣API运行状况、事件和修复程序：

易趣API状态 -官方状态页面
API状态RSS提要 -最新问题和解决方案（XML）
ebay_get_api_status -从该提要返回最新项目的MCP工具（按状态或API名称筛选，可选限制）
最新快照（自动更新） -最近状态项的回购摘要

文档

易趣开发者门户 -API文件和证书
易趣API许可协议 -使用条款和合规要求
易趣数据处理要求 -重要的数据保护和隐私准则
MCP文件 -模型上下文协议规范
OAuth快速参考 - 完整的OAuth身份验证指南，包括范围、故障排除和示例
OAuth设置指南 -详细的身份验证配置
贡献指南 -如何为这个项目做出贡献
行为准则 -社区指导方针和期望
更新日志 -版本历史和发行说明
安全策略 -漏洞报告指南

支持

问题追踪器 -Bug报告和功能请求
Bug报告模板 -详细的错误报告指南

许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

贡献者

感谢所有帮助这个项目变得更好的杰出贡献者！ 🎉

致谢

eBay开发者计划用于API访问
模型上下文协议对于MCP规范

______________________________________________________________________

Ebay API MCP Server

快速接入

详细介绍

易趣API MCP服务器

一键式AI设置

⚠️ 免责声明

目录

特性

快速开始

1.获取易趣凭据

2.安装

3.运行安装向导

演示

可视化安装指南

查找您的凭据

运行安装向导

4.使用

配置

环境变量

OAuth身份验证

MCP客户端兼容性

速率限制

可用工具

使用示例

为更高的速率限制设置OAuth

管理库存

处理订单

创建营销活动

批量操作

发展

先决条件

贡献者快速入门

命令参考

添加新的API端点

项目结构

Docker支持

贡献

日志记录

日志级别

文件记录

日志输出示例

故障排除

常见问题

服务器未出现在Claude桌面中

身份验证错误

速率限制错误

工具工作不正常

诊断工具

获取帮助

资源

API状态

文档

支持

许可证

贡献者

致谢

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP