boxberry-mcp

🗄 仓库已归档

开发工作已迁移至 theYahia/WWmcp——面向非西方 API 的 MCP 服务单体仓库，涵盖独联体国家、MENA、非洲、LATAM、东南亚。共享核心 @theyahia/mcp-core、统一 CI、统一发布流水线。

此处内容的最新版本：servers/boxberry/

npm 中的包保持不变——@theyahia/boxberry-mcp，安装和使用方式与以前相同。 此处不再进行任何更新。请在 WWmcp 中提交问题和 pull request。

**已归档——开发工作已迁移至 theYahia/WWmcp，**这是一个面向非西方 API 的 MCP 服务单体仓库。 此软件包的当前版本现位于 servers/boxberry/。 npm 包 @theyahia/boxberry-mcp 保持不变。 请在那里提交问题和 pull request。

Boxberry MCP — 通过与 AI 对话计算运费并查找自提点

如果你想知道如何通过普通提问计算 Boxberry 运费、查找客户所在城市最近的自提点，或者无需登录个人账户就能通过运单号追踪包裹，那么这就是你要找的工具。基于 Boxberry API 提供 6 种工具：城市、自提点、运费计算、追踪、邮编查询和服务列表。

功能（6 种工具）

工具	描述
list_cities	Boxberry 城市列表，支持按名称搜索
list_points	指定城市的自提点
calc_delivery	计算运费和配送时效
track	通过运单号追踪货件
zip_check	检查邮政编码是否属于配送区域
list_services	货件已提供的服务列表

快速开始（stdio）

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

HTTP 传输（Streamable HTTP）

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

通过 PORT 配置端口：

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

Smithery

已包含 smithery.yaml 文件。需要 BOXBERRY_API_TOKEN。

环境变量

变量	必需	描述
BOXBERRY_API_TOKEN	是	从 Boxberry 个人账户获取的 API 令牌
PORT	否	HTTP 传输端口（默认为 3000）

Skills（Claude Code）

Skill	描述
/skill-track <трек>	追踪 Boxberry 包裹
/skill-calculate <город> <вес>	计算运费
/delivery <город> <вес>	完整流程：城市 → 自提点 → 计算运费

开发

npm install
npm run build
npm test
BOXBERRY_API_TOKEN=<TOKEN> npm run dev

许可证

MIT

---

Telegram： @vhodvai