Boxberry Mcp

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

MCP server for Boxberry delivery API — city/point search, delivery calculation, tracking. 4 tools.

已验证STDIO仅桌面位置与生活商业与电商

概览

AI 生成的概览

Boxberry 配送 API 的 MCP 服务器，让助手查询城市与自提点、计算配送费用与时效，并追踪包裹。

可以做什么
  • 按名称搜索 Boxberry 城市，并列出指定城市的自提点
  • 计算配送费用与预计时效
  • 按运单号追踪包裹，并校验邮政编码是否在配送区域内
  • 查询某笔寄件的已提供附加服务
适用场景
适合在对话中直接回答配送问题：报价 Boxberry 运费与时效、查找客户所在城市最近的自提点，或查询包裹状态，而无需登录 Boxberry 账户。
运行要求
通过 npx 从 npm 包 @theyahia/boxberry-mcp 以 stdio 在本地运行，需要 Node.js。需要 Boxberry 个人账户中的 API 令牌；清单中变量名为 BOXBERRY_TOKEN，而 README 使用 BOXBERRY_API_TOKEN，请确认所装版本实际读取的名称。可选 PORT 变量可启用 HTTP 传输。
安装前请注意
API 令牌是与 Boxberry 账户绑定的凭据，请勿放入共享配置。README 示例使用 BOXBERRY_API_TOKEN，而清单声明 BOXBERRY_TOKEN，名称不一致可能导致认证静默失败。该仓库已归档，开发已迁至另一单体仓库，此包可能不再更新。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Boxberry Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

🗄 Репозиторий заархивирован

Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро @theyahia/mcp-core, единый CI, единый релизный конвейер.

Актуальная версия того, что лежало здесь: servers/boxberry/

Пакет в npm прежний — @theyahia/boxberry-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.

Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at servers/boxberry/. The npm package @theyahia/boxberry-mcp is unchanged. Please open issues and pull requests there.

Boxberry MCP — расчёт доставки и пункты выдачи в диалоге с нейросетью

Если вы искали, как посчитать стоимость доставки Boxberry обычным вопросом, найти ближайший пункт выдачи в городе клиента или отследить посылку по трек-номеру не заходя в личный кабинет — это оно. 6 инструментов поверх API Boxberry: города, пункты выдачи, расчёт доставки, отслеживание, проверка индекса и список услуг.

Возможности (6 инструментов)

ИнструментОписание
list_citiesСписок городов Boxberry с поиском по названию
list_pointsПункты выдачи в указанном городе
calc_deliveryРасчёт стоимости и сроков доставки
trackОтслеживание отправления по трек-номеру
zip_checkПроверка почтового индекса на зону доставки
list_servicesСписок оказанных услуг по отправлению

Быстрый старт (stdio)

json
{  "mcpServers": {    "boxberry": {      "command": "npx",      "args": ["-y", "@theyahia/boxberry-mcp"],      "env": {        "BOXBERRY_API_TOKEN": "<YOUR_TOKEN>"      }    }  }}

HTTP-транспорт (Streamable HTTP)

bash
BOXBERRY_API_TOKEN=<TOKEN> npx @theyahia/boxberry-mcp --http# Endpoint: http://localhost:3000/mcp# Health:   http://localhost:3000/health

Порт настраивается через PORT:

bash
PORT=8080 BOXBERRY_API_TOKEN=<TOKEN> npx @theyahia/boxberry-mcp --http

Smithery

Файл smithery.yaml включён. Требует BOXBERRY_API_TOKEN.

Переменные окружения

ПеременнаяОбязательнаяОписание
BOXBERRY_API_TOKENДаAPI-токен из личного кабинета Boxberry
PORTНетПорт для HTTP-транспорта (по умолчанию 3000)

Skills (Claude Code)

SkillОписание
/skill-track <трек>Отследить посылку Boxberry
/skill-calculate <город> <вес>Расчёт стоимости доставки
/delivery <город> <вес>Полный цикл: город → ПВЗ → расчёт

Разработка

bash
npm installnpm run buildnpm testBOXBERRY_API_TOKEN=<TOKEN> npm run dev

Лицензия

MIT

Telegram: @vhodvai

来源：README.md，提交 132c152

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

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

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

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

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