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

Spaceship AI MCP 服务器

Spaceship AI 的 MCP 服务器 — 可直接从 Claude Code、Cursor、VS Code 和 Windsurf 构建、运行和管理 AI 智能体。

快速开始

不想手动配置 MCP 服务器？

运行 spaceshipai@latest init，通过一条命令自动完成所有设置：

npx spaceshipai@latest init

这适用于 Claude Code、Cursor、VS Code 和 Windsurf。它将通过浏览器进行身份验证，为您创建 Spaceship API 密钥，并自动配置您的编辑器。

手动安装

如果您更喜欢手动配置，请将以下内容添加到您 IDE 的 MCP 配置文件中。

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_..."
      }
    }
  }
}

请从 spaceshipai.io 的 Settings → API Keys 获取您的 API 密钥。

工具

项目

工具	描述
`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`	用于本地开发或测试环境的覆盖地址

开发

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

许可证

MIT

Spaceship MCP

Spaceship AI MCP 服务器

快速开始

手动安装

工具

项目

智能体

运行智能体

编排

工具

提示词示例

配置

开发

许可证

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API