Сервер MCP
Пакет @tenergy/mcp реализует спецификацию Model Context Protocol (MCP) поверх публичного API платформы. Ваш AI-ассистент может рассчитывать цены, получать котировки и заказывать энергию; сервер подписывает запросы вашим API-ключом, при этом сам секрет никогда не передается языковой модели.
Инструменты (Tools)
| Инструмент | Требует ключ | Назначение |
|---|---|---|
get_prices, get_address_resources | Нет | Сетка цен; остаток энергии и пропускной способности на адресе |
estimate_transfer | Да | Расчет стоимости одного перевода USDT на адрес получателя |
get_balance, get_deposit_addresses | Да | Баланс аккаунта; адреса для пополнения |
create_quote, create_order | Да (с правом списания) | Фиксация цены на 120 с; покупка энергии |
get_order, list_orders | Да | Статус и история заказов |
Доступные ресурсы: tenergy://docs/quickstart, tenergy://llms.txt.
Установка и запуск
Запуск сервера: npx -y @tenergy/mcp (режим stdio) или npx -y @tenergy/mcp --http 3333 (потоковый HTTP по адресу http://localhost:3333/mcp).
Claude Desktop — файл claude_desktop_config.json:
{"mcpServers":{"tenergy":{"command":"npx","args":["-y","@tenergy/mcp"],"env":{"TENERGY_API_KEY":"...","TENERGY_API_SECRET":"..."}}}}
Claude Code:
claude mcp add tenergy -e TENERGY_API_KEY=... -e TENERGY_API_SECRET=... -- npx -y @tenergy/mcp
ChatGPT (Настройки → Connectors → режим разработчика → добавить Connector): запустите npx -y @tenergy/mcp --http 3333 за публичным HTTPS-туннелем и укажите адрес https://<ваш-хост>/mcp.
Cursor / Antigravity — файл mcp.json:
{"mcpServers":{"tenergy":{"command":"npx","args":["-y","@tenergy/mcp"],"env":{"TENERGY_API_KEY":"...","TENERGY_API_SECRET":"..."}}}}
Переменные окружения
| Переменная | По умолчанию | Описание |
|---|---|---|
TENERGY_API_URL | https://api-nile.tenergy.me/v1 (Nile) | Базовый URL API с префиксом /v1; для работы в основной сети укажите хост Mainnet |
TENERGY_API_KEY, TENERGY_API_SECRET | не заданы | Пара ключей для подписания запросов (не передаются в модель). Если не заданы — доступны только публичные методы |
TENERGY_SITE_URL | https://tenergy.me | Хост документации для ресурсов |
TENERGY_MCP_READ_ONLY | не задан | Значение 1 отключает методы create_quote и create_order даже при наличии прав на списание |
TENERGY_MCP_MAX_ORDER_TRX | 50 | Лимит суммы одного заказа; ордера дороже указанного порога отклоняются до списания |
Правила безопасности
| Правило | Причина |
|---|---|
| Сервер откажется запускаться, если переменные напоминают приватный ключ кошелька (64 hex-символа) | Сервер не подписывает ончейн-транзакции; приватному ключу здесь не место |
Метод create_order требует max_price_sun и client_order_id | Защита от резких скачков цен и гарантия идемпотентности |
Заказы дороже TENERGY_MCP_MAX_ORDER_TRX отклоняются до списания | Защита от случайного исчерпания баланса агентом за один запрос |
| Назначайте ключу только минимально необходимые скоупы | Подробнее в разделе Аутентификация |
| Тестируйте поведение агента сначала в Nile | В разделе Окружения описаны особенности тестнета |