Claude Info
AI и агенты

Spaceship AI MCP

Spaceship-AI/spaceship-mcp

MCP-сервер для платформы Spaceship AI: создавайте, запускайте и управляйте AI-агентами из Claude Code, Cursor, VS Code и Windsurf. Поддержка оркестраций, логов выполнения и встроенных инструментов.

Установка

terminal
bash
claude mcp add --scope user --transport stdio spaceship --env SPACESHIP_API_KEY=sk_live_... -- uvx spaceship-mcp

README

ansi
       ███████╗██████╗  █████╗  ██████╗███████╗███████╗██╗  ██╗██╗██████╗    █████╗ ██╗
       ██╔════╝██╔══██╗██╔══██╗██╔════╝██╔════╝██╔════╝██║  ██║██║██╔══██╗  ██╔══██╗██║
       ███████╗██████╔╝███████║██║     █████╗  ███████╗███████║██║██████╔╝  ███████║██║
       ╚════██║██╔═══╝ ██╔══██║██║     ██╔══╝  ╚════██║██╔══██║██║██╔═══╝   ██╔══██║██║
       ███████║██║     ██║  ██║╚██████╗███████╗███████║██║  ██║██║██║       ██║  ██║██║
       ╚══════╝╚═╝     ╚═╝  ╚═╝ ╚═════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝╚═╝       ╚═╝  ╚═╝╚═╝

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 — выполните в терминале:

bash
claude mcp add --scope user --transport stdio spaceship --env SPACESHIP_API_KEY=sk_live_... -- uvx spaceship-mcp

Или добавьте в ~/.claude.json:

json
{
  "mcpServers": {
    "spaceship": {
      "command": "uvx",
      "args": ["spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "sk_live_..."
      }
    }
  }
}

Cursor — добавьте в ~/.cursor/mcp.json:

json
{
  "mcpServers": {
    "spaceship": {
      "command": "uvx",
      "args": ["spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "sk_live_..."
      }
    }
  }
}

VS Code — добавьте в ~/.vscode/mcp.json:

json
{
  "servers": {
    "spaceship": {
      "command": "uvx",
      "args": ["spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "sk_live_..."
      }
    }
  }
}

Windsurf — добавьте в ~/.codeium/windsurf/mcp_config.json:

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Опрос статуса: queuedrunningcompleted / 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

Разработка

bash
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v

Лицензия

MIT

Похожие скиллы