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, див. Помилки.