← 返回目录
A

Avito MCP Server

社区
让 AI 代理管理您的 Avito 账户:回复买家、自动定价与推广、处理订单,自助完成日常运营。
分类
其他 第 71 / 230
Stars
★ 23 热门
传输方式
stdio(本地进程) · Streamable HTTP
运行环境
Node.js 22.12+
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
工具数
7
60FMRS · C

该服务器功能强大且工具数量众多,但官方状态不明,且需要信任包含 148 个工具的大规模 API 代理。安全机制(如双重确认、试运行)值得肯定,但用户需评估风险并仔细配置。

最强项 · 安装易用性 13/20 最弱项 · 维护活跃度 10/20

可靠性
11/20
安全与权限
13/20
维护活跃度
10/20
文档质量
13/20
安装易用性
13/20
查看各项评分依据
可靠性 11/20
README宣称915个测试、CI徽章、84%语句覆盖率和针对1.3.3进程的线路基线回放测试,并描述了幂等账本、dry-run、结构化错误分类与fail-fast配置解析,设计上对可靠性考虑周全。但根据静态校准规则,README属于不可信证据,所提供的源材料中没有可直接核实的测试文件或CI工作流内容,148个工具的声明行为(如幂等重放、确认门)无法验证,因此不给超过12分。扣分项:关键路径的可执行证据不可核实。
安全与权限 13/20
无红线问题:未发现恶意行为、凭据外传或不可逆默认操作。安全设计突出——金钱/公开操作默认两步确认且可加严格确认密钥、auth_*令牌工具默认隐藏、上传工具需显式目录白名单并有符号链接与magic bytes防护、令牌文件0600/目录0700、webhook注册限制为运营者配置的URL、dry-run输出脱敏。扣分项:这些均为README自述而非可审计源码;webhook认证仅靠URL路径中的秘密段;环境变量中的client_secret明文;确认机制自认'非人类批准的密码学证明';无执行验证下不能给满分。
维护活跃度 10/20
版本号规范(2.1.1)、SemVer承诺、MIGRATION.md与CHANGELOG被引用、SECURITY.md被引用(私有漏洞渠道)、CI徽章显示持续集成。但仓库许可元数据为NOASSERTION,与README中的MIT徽章矛盾,许可状态不明确构成治理缺口;实际的提交频率、issue响应、依赖更新节奏在提供的材料中无证据。扣分项:许可不一致、维护活跃度证据缺失。
文档质量 13/20
文档分层且详尽:快速开始、17+客户端配置表、工具分组与风险类别、环境变量参考表、HTTP部署与Caddy/nginx片段、故障排查提示(Claude Desktop托盘退出、日志路径)、明确的'未覆盖范围'与局限性声明(无沙箱、非MCP授权规范的bearer模式)。扣分项:全部为README自述,无独立的docs文件作为证据核验;API快照时效(2026年5月)依赖维护者更新;部分高级行为(ADR、safety.md)仅链接未展示。
安装易用性 13/20
安装路径清晰:Node 22.12+、npx一行命令、三凭据、逐客户端配置表覆盖主流客户端,HTTP模式默认关闭不影响新手上手,--health诊断与故障排查指南齐备。扣分项:需要用户自行从Avito开发者门户获取三个凭据(外部前置步骤);按静态校准规则无文件内可核实的执行证据,上限15分之下再扣,且148工具规模、协议时代变量等增加了实际配置复杂度。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络修改第三方账户数据

适合谁

  • 希望减少手动操作时间的 Avito 卖家
  • 需要通过 API 自动化管理多个商店或商品的高级用户

不适合谁

  • 没有 Avito 账户或未注册开发者凭证的人
  • 需要沙箱环境进行测试的开发者(Avito 不提供沙箱凭证)
  • 希望完全离线且不依赖外部服务的用户

所需权限

  • 读取和回复聊天消息(需消息权限)
  • 修改商品信息、价格和推广(需列表权限)
  • 管理订单和发货(需订单权限)
  • 访问账户余额和分析数据(需财务权限)

风险与副作用

  • 所有操作都在真实生产环境执行,没有沙盒;误操作可能导致资金损失或账户风险。
  • 存储凭据在配置中,需确保安全存储,避免泄露。
  • 默认情况下,高风险操作需要确认,但若配置不当仍可能执行意外操作。
  • 依赖外部服务 Avito API,可能受速率限制或服务变更影响。

安装接入

准备工作

运行环境:Node.js 22.12+

AVITO_MCP_CONFIRMATION_SECRET 可选密钥 启用硬性确认门禁的机密口令。
AVITO_MCP_OAUTH_OWNER_PASSWORD 可选密钥 oauth 模式必填,至少 32 字节的随机口令,是签发 token 的唯一凭据。
AVITO_MCP_HTTP_AUTH_TOKEN 可选密钥 bearer 模式下的共享密钥,逗号分隔,每个至少 32 字节。
AVITO_MCP_WEBHOOK_SECRET 可选密钥 Avito webhook 接收器路径密钥,至少 32 字节随机值。
其他可选配置项(30 个)
AVITO_MCP_PROTOCOL_ERA 可选 选择服务哪个 MCP 协议版本:legacy(默认)、dual 或 modern。
AVITO_MCP_MODE 可选 运行模式:full_access(默认)、guarded 或 read_only,控制暴露的工具数量。
AVITO_MCP_DRY_RUN_DEFAULT 可选 设为 true 时所有破坏性操作默认只打印将发出的 HTTP 请求而不执行。
AVITO_MCP_CONFIRMATION_MODE 可选 确认流模式;设为 off 会减少 3 个 meta 工具。
AVITO_MCP_APPROVAL_MODE 可选 设为 external 时要求确认者与发起者身份不同。
AVITO_MCP_IDEMPOTENCY_TTL_SEC 可选 幂等账本记录的存活时间,默认 1 小时。
AVITO_MCP_RUNTIME_STATE_DIR 可选 幂等账本等运行时状态的存储目录。
AVITO_MCP_TOKEN_LOCK_TIMEOUT_MS 可选 多进程共享 token 文件时锁的等待超时,默认 30 秒。
AVITO_MCP_ALLOW_TOOLS 可选 按名称白名单限制可见工具。
AVITO_MCP_DENY_TOOLS 可选 按名称黑名单隐藏工具。
AVITO_MCP_EXPOSE_AUTH_TOOLS 可选 设为 1 时暴露三个会返回 OAuth token 的 auth_* 工具。
AVITO_MCP_ALLOWED_UPLOAD_DIRS 可选 允许 messenger_upload_images 读取图片的目录白名单,不设则该工具不注册。
AVITO_MCP_TRANSPORT 可选 传输方式:stdio(默认)、http 或 both。
AVITO_MCP_HTTP_HOST 可选 HTTP 监听地址,默认 127.0.0.1,建议保持回环。
AVITO_MCP_HTTP_PUBLIC_URL 可选 对外 HTTPS 域名,作为 OAuth issuer 标识。
AVITO_MCP_HTTP_AUTH 可选 HTTP 鉴权方式:oauth(默认)、bearer 或 none。
AVITO_MCP_OAUTH_TOKEN_TTL_SEC 可选 签发的 bearer token 有效期,默认 3600 秒。
AVITO_MCP_OAUTH_STORE_FILE 可选 持久化客户端/token 存储文件,同一文件只能一个进程使用。
AVITO_MCP_HTTP_ALLOWED_HOSTS 可选 DNS 重绑定防护允许的 Host 列表,派生失败即拒绝启动。
AVITO_MCP_HTTP_ALLOW_INSECURE_PUBLIC_URL 可选 仅开发用,允许明文 issuer,默认 0。
AVITO_MCP_HTTP_ALLOW_NO_AUTH 可选 允许非回环地址关闭鉴权,不建议开启。
AVITO_MCP_HTTP_MAX_SESSIONS 可选 legacy 版本的最大并发会话数,默认 100。
AVITO_MCP_HTTP_SESSION_IDLE_SEC 可选 legacy 版本空闲会话回收时间,默认 1800 秒。
AVITO_MCP_HTTP_MAX_INFLIGHT 可选 2026-07-28 版本最大并发 /mcp 请求,默认 64。
AVITO_MCP_HTTP_MAX_STREAMS 可选 其中允许的长订阅流数量,默认 32。
AVITO_MCP_WEBHOOK_PUBLIC_URL 可选 Avito 回调的公网 HTTPS 地址,默认取 HTTP public URL。
AVITO_MCP_WEBHOOK_PATH 可选 webhook 接收路径,默认 /avito/webhook。
AVITO_MCP_WEBHOOK_BUFFER 可选 webhook 事件缓冲条数,默认 100。
AVITO_MCP_WEBHOOK_LOG_FILE 可选 可选的事件日志文件(0600 权限,10 MiB 轮转)。
AVITO_TOKEN_FILE 可选 OAuth token 缓存文件位置,覆盖默认路径。
  1. 从 Avito 开发者门户获取 Client_id、Client_secret 和 Profile_id。
  2. 在 MCP 客户端配置中添加上述 JSON。
  3. 重启客户端并开始使用。
claude_desktop_config.json
{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp"
      ],
      "env": {
        "Client_id": "YOUR_CLIENT_ID",
        "Client_secret": "YOUR_CLIENT_SECRET",
        "Profile_id": "YOUR_PROFILE_ID"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "avito": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp"
      ],
      "env": {
        "Client_id": "YOUR_CLIENT_ID",
        "Client_secret": "YOUR_CLIENT_SECRET",
        "Profile_id": "YOUR_PROFILE_ID"
      }
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

Terminal
claude mcp add avito -e Client_id=YOUR_CLIENT_ID -e Client_secret=YOUR_CLIENT_SECRET -e Profile_id=YOUR_PROFILE_ID -- npx -y avito-mcp

在终端运行;先把 <…> 占位符换成你自己的值。

验证是否装好

在 MCP 客户端配置中填入 Client_id、Client_secret 和 Profile_id 后重启客户端,询问「我的 Avito 余额和未读聊天数是多少?」;若返回真实数字,说明 stdio 连接和 OAuth 凭据均已生效。

常见排障

  1. 1. 确保 Node.js 版本不低于 22.12。
  2. 2. 检查环境变量是否正确设置,客户端 ID、密匙和配置文件 ID 是否有效。
  3. 3. 查看服务器日志:在 Claude Desktop 中检查 ~/Library/Logs/Claude/mcp-server-avito.log(macOS)
  4. 4. 使用 meta_health 工具检查服务器状态;
  5. 5. 若连接失败,检查网络和 Avito API 可达性。

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 我的 Avito 余额是多少,有几条未读聊天?
  • 列出我最近的未读聊天,但先不要发送任何回复。
  • 把商品 12345 的价格改为 1400 卢布,先用 dryRun 预演一下。
  • 查看当前的 Avito API 速率限制状态。

工具能力 7

messenger_get_chats 只读
获取消息列表,支持按聊天 ID 等筛选,用于查看未读消息。
listing_update_price 写入
更新商品价格,可传入 dryRun 参数进行预演。
order_ship 写入
标记订单发货,支持使用幂等键确保重复调用不重复扣费。
meta_confirm_action 写入
确认待执行的敏感或资金相关操作,需提供操作 ID。
meta_health 只读
输出服务器运行状态、版本和计数器等健康信息。
meta_auth_status 只读
检查认证状态,可选 probe 参数触发令牌刷新。
meta_capabilities 只读
报告当前启用的模式、允许/拒绝工具数量及功能标志。

使用场景

自动处理客户咨询和聊天回复
自动调整商品价格并管理推广活动
订单处理与发货物流跟踪
获取账户余额、销售分析等实时数据

支持客户端

Claude Desktop
Claude Code
Cursor
Windsurf

依据项目文档列出,未经本站实测。

详细介绍

Avito MCP 服务器将 Avito 账户接入 AI 代理,使其能够自动回复聊天、更新列表价格和推广、管理订单、上传发货标签及执行其他任务,覆盖了 Avito 18 个官方 API 的 148 个工具。该服务器内置多种安全机制:涉及资金或公开发布的操作需要二次确认、支持试运行以及幂等重试,确保自动操作的安全性。默认使用 stdio 传输,可运行于本地;同时支持基于 OAuth 2.1 的 HTTP 远程部署。适合希望减少手动操作的 Avito 卖家,但需注意掌握操作权限并确保安全配置。

同类可选方案

BioMCP 75 · B

统一的命令行语法,接入约30个可信生物医学数据源。

★ 659 · 工具数 11 与当前对比 →

源版本 047b21e6b787 数据同步于 2026-10-19 查看 FMRS 评分方法