Spacebridge MCP

🚀 SpaceBridge - MCP 服務器中文指南

SpaceBridge - MCP 服務器為用戶提供了便捷的 MCP 連接服務，支持多種安裝方式，可輕鬆配置客戶端連接，還具備豐富的使用技巧和開發指南，助力用戶高效使用。

🚀 快速開始

若你想快速體驗 SpaceBridge - MCP 服務器，可按以下步驟操作：

1. 安裝服務器（可選擇從源碼安裝或直接安裝）。
2. 啟動服務器。
3. 配置客戶端連接。

📦 安裝指南

方式一：從源碼安裝

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 服務器！