Spaceship AI MCP
Spaceship-AI/spaceship-mcpMCP-сервер для платформы Spaceship AI: создавайте, запускайте и управляйте AI-агентами из Claude Code, Cursor, VS Code и Windsurf. Поддержка оркестраций, логов выполнения и встроенных инструментов.
Установка
claude mcp add --scope user --transport stdio spaceship --env SPACESHIP_API_KEY=sk_live_... -- uvx spaceship-mcpREADME
███████╗██████╗ █████╗ ██████╗███████╗███████╗██╗ ██╗██╗██████╗ █████╗ ██╗
██╔════╝██╔══██╗██╔══██╗██╔════╝██╔════╝██╔════╝██║ ██║██║██╔══██╗ ██╔══██╗██║
███████╗██████╔╝███████║██║ █████╗ ███████╗███████║██║██████╔╝ ███████║██║
╚════██║██╔═══╝ ██╔══██║██║ ██╔══╝ ╚════██║██╔══██║██║██╔═══╝ ██╔══██║██║
███████║██║ ██║ ██║╚██████╗███████╗███████║██║ ██║██║██║ ██║ ██║██║
╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═╝╚═╝Spaceship AI MCP Server
MCP-сервер для Spaceship AI — создавайте, запускайте и управляйте AI-агентами прямо из Claude Code, Cursor, VS Code и Windsurf.
Быстрый старт
Не хотите настраивать MCP-сервер вручную?
Запустите spaceshipai@latest init — всё настроится автоматически одной командой:
npx spaceshipai@latest init
Работает с Claude Code, Cursor, VS Code и Windsurf. Команда выполнит аутентификацию через браузер, создаст API-ключ Spaceship и автоматически настроит ваш редактор.
Ручная установка
Если предпочитаете настраивать вручную, добавьте следующее в конфигурационный файл MCP вашей IDE.
Claude Code — выполните в терминале:
claude mcp add --scope user --transport stdio spaceship --env SPACESHIP_API_KEY=sk_live_... -- uvx spaceship-mcpИли добавьте в ~/.claude.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}Cursor — добавьте в ~/.cursor/mcp.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}VS Code — добавьте в ~/.vscode/mcp.json:
{
"servers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}Windsurf — добавьте в ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}Получите API-ключ на spaceshipai.io в разделе Settings → API Keys.
Инструменты
Проекты
| Инструмент | Описание |
|---|---|
list_projects | Список всех проектов в вашей организации |
Агенты
| Инструмент | Описание |
|---|---|
list_agents | Список агентов с опциональной фильтрацией по проекту |
get_agent | Полные сведения об агенте: системный промпт и инструменты |
create_agent | Создание агента; передайте description для автогенерации системного промпта |
update_agent | Обновление имени, промпта или инструментов; повторная генерация через новый description |
delete_agent | Безвозвратное удаление агента вместе с логами, памятью и тредами |
Запуск агентов
| Инструмент | Описание |
|---|---|
run_agent | Запуск асинхронного выполнения; возвращает execution_id для опроса статуса |
get_run_status | Опрос статуса: queued → running → completed / error / cancelled |
get_run_logs | Полный хронологический лог событий завершённого запуска |
list_executions | Список последних запусков агента со статусом и длительностью |
test_agent | Быстрый синхронный тест — запускает агента и ждёт результат до 15 секунд |
Оркестрации
| Инструмент | Описание |
|---|---|
list_orchestrations | Список оркестраций с опциональной фильтрацией по проекту |
get_orchestration | Полные сведения об оркестрации: участники и инструменты |
run_orchestration | Запуск асинхронной оркестрации; возвращает execution_id |
test_orchestration | Быстрый синхронный тест — запускает оркестрацию и ждёт результат до 15 секунд |
Инструменты
| Инструмент | Описание |
|---|---|
list_tools | Список встроенных и пользовательских инструментов, доступных для подключения к агентам |
Примеры промптов
После установки можно общаться с агентами в любой поддерживаемой IDE на естественном языке:
List my projects, then show me all agents in the "production" project.
Create an agent called "Support Bot" in project 12 that handles customer refund requests.
Run the "Data Processor" agent with the prompt "Summarize last week's sales data".
Check the status of execution abc-123 for agent xyz-456, then show me the logs.
Test the "Email Classifier" agent with "Is this email spam: win a free iPhone now!"
List my orchestrations in the "production" project, then run the "Data Pipeline" orchestration.
Test the "Research Team" orchestration with input {"topic": "AI safety"} and show me the result.
Конфигурация
| Переменная | Обязательная | По умолчанию | Описание |
|---|---|---|---|
SPACESHIP_API_KEY | Да | — | Ваш API-ключ (sk_live_...) |
SPACESHIP_API_URL | Нет | https://spaceshipai.io | Переопределение для локальной разработки или staging |
Разработка
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -vЛицензия
MIT