MCP-сервер
Дайте ИИ-агенту в Claude Code, Claude Desktop или Cursor читать терминал, торговать и менять раскладку.
spectre-terminal-mcp — это сервер Model Context Protocol, который даёт
ИИ-агенту запущенный терминал: рыночные данные, счёт, торговлю, раскладку и
настройки. Он работает на вашей машине и говорит с терминалом через
Local API.
Установка
pip install spectre-terminal-mcpЗатем включите Local API в терминале и скопируйте токен. См. Получить токен.
Настроить сервер в вашем клиенте
claude mcp add spectre-terminal -e SPECTRE_LOCAL_API_TOKEN=spt_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -- spectre-terminal-mcpТокен выше — пример, подставьте свой. Claude Desktop хранит этот блок в
claude_desktop_config.json. Cursor и другие клиенты с конфигурацией в JSON
принимают тот же блок.
Сервер читает токен только из окружения и находит терминал сам. Он
запускается, даже когда терминал не запущен. Тогда первый вызов инструмента
MCP отвечает terminal_unreachable, а следующий вызов ищет терминал
заново.
Что может агент
| Раздел | Что может агент | Что-то меняет |
|---|---|---|
| Состояние | Проверить, что терминал работает, и перечислить его подключения | Нет |
| Инструменты | Найти точный адрес монеты или символа | Нет |
| Рыночные данные | Прочитать последнюю цену, верх стакана, сводку последних сделок, кластеры объёма и свечи | Нет |
| Счёт | Прочитать балансы, позиции, открытые заявки, исполнения и плечо | Нет |
| Торговля | Ставить и снимать заявки и триггерные заявки, закрыть позицию, задать плечо и режим маржи | Да |
| Рабочее пространство | Прочитать раскладку. Открывать, менять и закрывать стеки, вкладки и окна | Да, кроме чтения |
| Настройки | Читать настройки и записывать их | Да, кроме чтения |
Все инструменты MCP с их аргументами перечислены в справочнике инструментов MCP.
Ответы — это короткие сводки для модели, а не сырые данные. Цены и объёмы — десятичные строки. Время — в миллисекундах UTC, рядом стоит копия в формате ISO.
Инструменты MCP, которые только читают, помечены как «только чтение», поэтому клиент может вызывать их, не спрашивая вас. Инструменты MCP, которые торгуют, меняют раскладку или записывают настройки, помечены как деструктивные, поэтому клиент может спрашивать вас перед каждым вызовом.
Живого стрима нет. Агент, которому нужны свежие данные, снова вызывает
market_snapshot. Программа, которой нужны живые данные, использует
стрим.
Инструмент, который не открыт в терминале, на первом вызове отвечает до 3 секунд, см. Первый вызов.
Торговать безопасно
Реальные деньги. Инструменты MCP для торговли отправляют на биржу настоящие заявки через терминал. Своего подтверждения сервер не спрашивает. Спросят ли вас перед вызовом, зависит от вашего MCP-клиента.
Переключатель Local API в терминале — это стоп-кран. Выключите его, и агент больше не сможет ни читать, ни торговать.
Торговый ответ — это accepted, а не «исполнено». Исход агент читает через
open_orders и recent_fills.
place_order и place_trigger требуют client_key. Повторный вызов с тем
же ключом ничего нового не ставит.
Сервер никогда не видит ключи бирж, а токен никогда не попадает в сообщения.
Что недоступно
Московская биржа (MOEX) не обслуживается. Агент не может перенести несколько заявок разом, перенести стек между вкладками или изменить ширину колонок.
Решение проблем
Неудачный вызов — это ошибка инструмента MCP. Её текст начинается со стабильного кода.
| Код | Почему | Что делать |
|---|---|---|
terminal_unreachable | Терминал не запущен или его Local API выключен | Запустить терминал и включить Local API |
local_api_disabled | Local API выключен | Включить его в Settings App → Общие → Local API |
token_missing | SPECTRE_LOCAL_API_TOKEN не задан для сервера | Добавить токен в конфигурацию сервера |
unauthorized | Токен не совпадает | Скопировать текущий токен в конфигурацию |
incompatible_terminal | Терминал отдаёт другую версию API | См. Совместимость |
not_active | Кластеры или плечо инструмента ещё не загружены | Спросить ещё раз через несколько секунд или открыть инструмент в терминале |
rate_limited | Больше 50 инструментов открыто только для API или больше 5 новых в секунду | Снизить темп |
Остальные коды — это коды API, см. Ошибки.