io.github.theYahia/boxberry-mcp
MCP server for Boxberry delivery API — city/point search, delivery calculation, tracking. 4 tools.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@theyahia/boxberry-mcpclaude mcp add boxberry-mcp -e 'BOXBERRY_TOKEN=<your boxberry_token>' -- npx -y @theyahia/boxberry-mcp@1.0.2
{
"mcpServers": {
"boxberry-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/boxberry-mcp@1.0.2"
],
"env": {
"BOXBERRY_TOKEN": "<your boxberry_token>"
}
}
}
}
Variables d'environnement
BOXBERRY_TOKENobligatoire secret API key for the service
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
🗄 Репозиторий заархивирован
Разработка переехала в 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-mcpis 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)
{
"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 | Да | API-токен из личного кабинета Boxberry |
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
Questions fréquentes
Qu'est-ce que io.github.theYahia/boxberry-mcp ?
MCP server for Boxberry delivery API — city/point search, delivery calculation, tracking. 4 tools.
Comment installer io.github.theYahia/boxberry-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add boxberry-mcp -e 'BOXBERRY_TOKEN=<your boxberry_token>' -- npx -y @theyahia/boxberry-mcp@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.theYahia/boxberry-mcp ?
Oui. Il attend BOXBERRY_TOKEN, à renseigner dans sa configuration.
io.github.theYahia/boxberry-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.theYahia/boxberry-mcp ?
Il est publié par theYahia. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.