Spacebridge MCP

🚀 SpaceBridge-MCP サーバー日本語ガイド

SpaceBridge-MCP サーバーは、MCP 接続を効率的に管理するためのサーバーです。このガイドでは、サーバーのインストール、実行、クライアント接続設定、使用技巧などについて詳しく説明します。

🚀 クイックスタート

このセクションでは、SpaceBridge-MCP サーバーの基本的な使い方を説明します。

📦 インストール

方法1：ソースコードからインストール

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

方法2：直接インストール

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 サーバーをご利用いただき、ありがとうございます！