SpaceBridge-MCP 服务器中文指南

安装说明

方式一：从源码安装

1. 克隆项目仓库：

   git clone git@github.com:your-repository.git
   cd spacebridge-mcp
   

2. 创建并激活虚拟环境（推荐）：

   python -m venv .venv
   source .venv/bin/activate  # 在 macOS/Linux 下
   .\.venv\Scripts\activate    # 在 Windows 下
   

3. 安装依赖：

   pip install -r requirements.txt
   

方式二：直接安装

pip install spacebridge-mcp

服务器运行

启动服务器：

spacebridge-mcp-server

默认情况下，服务器将通过标准输入输出（stdio）监听 MCP 连接。

客户端连接配置

配置步骤：

1. 安装：确保 spacebridge-mcp 已正确安装。
2. 找到服务器路径：
   • 如果在虚拟环境中安装，路径可能是 /path/to/your/project/.venv/bin/spacebridge-mcp-server
   • 如果全局安装，可以使用命令 which spacebridge-mcp-server（macOS/Linux）或 where spacebridge-mcp-server（Windows）查找。
3. 添加到客户端：在 MCP 客户端中添加新服务器。

示例：Claude code 使用

claude mcp add spacebridge \
  /full/path/to/your/spacebridge-mcp-server \
  --scope user \
  --env SPACEBRIDGE_API_URL="https://your-spacebridge.com/api" \
  --env SPACEBRIDGE_API_KEY="your-spacebridge-api-key" \
  --env OPENAI_API_KEY="your-openai-api-key" \
  --env SPACEBRIDGE_ORG_NAME="your-explicit-org" \      # 如果需要
  --env SPACEBRIDGE_PROJECT_NAME="your-explicit-project" # 如果需要

• --scope user 表示该服务器对所有项目可用；--scope project 则限制为当前项目。

其他客户端（如 Windsurf、Cursor）

请参考具体客户端的文档，确保传递以下环境变量：

• SPACEBRIDGE_API_URL
• SPACEBRIDGE_API_KEY
• OPENAI_API_KEY
• 以及可选的 SPACEBRIDGE_ORG_NAME 和 SPACEBRIDGE_PROJECT_NAME

使用技巧与自动化工作流

自动化提交信息

配置 AI 工具（如 Claude code、Windsurf、Cursor）生成提交信息时自动引用相关问题 ID。

示例规则/指令：

• "在生成提交信息时，始终询问 SpaceBridge-MCP 工具查找或创建与更改相关的 issue，并引用其 ID。"

快速访问

使用以下命令快速启动服务器：

python -m spacebridge_mcp.main

开发指南

环境搭建

1. 克隆项目仓库。
2. 创建并激活虚拟环境（推荐）。

调试模式启用

在开发环境中启用调试功能：

SPACEBRIDGE_DEBUG=1 spacebridge-mcp-server

贡献指南

1. 提交代码前，请确保通过所有测试用例。
2. 遵循 贡献规范。

问题反馈

如遇任何问题或需要帮助，请联系：

• 邮件：support@spacebridge.com
• GitHub：Issues 页面

感谢您使用 SpaceBridge-MCP 服务器！