使用说明
███████╗██████╗ █████╗ ██████╗███████╗███████╗██╗ ██╗██╗██████╗ █████╗ ██╗
██╔════╝██╔══██╗██╔══██╗██╔════╝██╔════╝██╔════╝██║ ██║██║██╔══██╗ ██╔══██╗██║
███████╗██████╔╝███████║██║ █████╗ ███████╗███████║██║██████╔╝ ███████║██║
╚════██║██╔═══╝ ██╔══██║██║ ██╔══╝ ╚════██║██╔══██║██║██╔═══╝ ██╔══██║██║
███████║██║ ██║ ██║╚██████╗███████╗███████║██║ ██║██║██║ ██║ ██║██║
╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═╝╚═╝
宇宙飞船AI MCP服务器
MCP服务器 宇宙飞船AI --直接从Claude Code、Cursor、VS Code和Windsurf构建、运行和管理AI代理。
快速开始
不想手动配置MCP服务器?
跑 spaceshipai@latest init 只需一个命令即可自动设置所有内容:
npx spaceshipai@latest init
这适用于Claude Code、Cursor、VS Code和Windsurf。它将通过浏览器进行身份验证,为您创建太空船API密钥,并自动配置编辑器。
手动安装
如果您更喜欢手动配置,请将以下内容添加到IDE的MCP配置文件中。
克劳德代码 --在您的终端中运行:
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/mcp.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}
VS代码 --添加到 ~/.vscode/mcp.json:
{
"servers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}
帆板运动 --添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}
从获取API密钥 太空船.io 在...之下 设置→ API密钥.
工具
项目
| 工具 | 说明 |
|---|---|
list_projects |
列出组织中的所有项目 |
代理
| 工具 | 说明 |
|---|---|
list_agents |
列出代理,可选择按项目筛选 |
get_agent |
获取单个代理的完整详细信息,包括其系统提示和工具 |
create_agent |
创建代理--pass 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
许可证
麻省理工学院