Bernerspace

🚀 バーナースペース (Bernerspace)

1つのMCPサーバーで、すべての統合をシームレスに実現

🚀 OAuth対応のすべての統合に対応する統一MCPサーバー
1つのサーバー · 1つのJWT · 多数のツール

✅ 現在稼働中の統合: Slack — 47のツールがテスト済みで利用可能
🔜 近日公開予定: Gmail · Googleカレンダー · Notion
🎯 目標: 100以上の統合

🚀 クイックスタート

環境設定

以下の変数を含む .env ファイルを作成します。

JWT_SECRET=your-jwt-signing-secret
DATABASE_URL=postgresql://localhost:5432/mcp_server
CLIENT_ID=<slack_client_id>
CLIENT_SECRET=<slack_client_secret>
SLACK_REDIRECT_URI=http://localhost:8000/mcp/slack/oauth/callback

依存関係のインストール

以下のいずれかの方法で依存関係をインストールします。

• pipを使用する場合
  • python3 -m venv .venv && source .venv/bin/activate
  • pip install -e .
• uvを使用する場合
  • uv venv && source .venv/bin/activate
  • uv pip install -e .

サーバーの起動

以下のいずれかの方法でサーバーを起動します。

• Pythonを使用する場合
  • python server.py
  • サーバーは http://localhost:8000 で待機します。
• Dockerを使用する場合
  • docker build -t bernerspace-mcp .
  • docker run --env-file .env -p 8000:8000 bernerspace-mcp
  • サーバーは http://localhost:8000 で待機します。
• Docker Composeを使用する場合
  • docker compose up -d

JWTの作成

MCPサーバーを呼び出すためのJWTを作成します。

• python generate_jwt.py --user-id <your_user_id>
• 出力されたトークンを Authorization: Bearer TOKEN として使用します。

✨ 主な機能

なぜバーナースペース (Bernerspace) が必要なのか

現在、MCPサーバーを使用または統合するのは困難です。その理由は以下の通りです。

• ほとんどのMCPサーバーはOAuth機能を備えておらず、ユーザー体験が制限されます。
• 各MCPサーバーには個別のデプロイと管理が必要で、運用オーバーヘッドが増加します。
• 統合の混乱: MCPサーバー間で異なる認証レイヤーが存在するため、統一された統合がほぼ不可能です。

得られるもの

• ミドルウェアを介したサービス間での単一JWT (HS256、発行者/対象者検証済み)。
• 各統合ごとのOAuthミドルウェア (Slackは稼働中; 今後追加予定) とDBバックアップのトークンストレージ。
• 各サービスに対する一貫したMCPツールインターフェイス。
• 自前でホストできる統一されたエンドポイント、例:
  • http://localhost:8000/mcp/slack
  • http://localhost:8000/mcp/gmail (近日公開予定)

📦 インストール

上述の「クイックスタート」セクションを参照してください。

💻 使用例

基本的な使用法

OAuthフロー (Slack)

• GET /mcp/slack は oauth_url とワークスペースの認証手順を返します。
• Slackは SLACK_REDIRECT_URI (デフォルトは /mcp/slack/oauth/callback) にリダイレクトします。
• サーバーはコードを交換し、トークンの詳細を充実させ、Postgresに保存します。
• トークンは oauth_tokens テーブルに複合キー (client_id, integration_type) で保存されます。ここで client_id はあなたのJWTのサブジェクト (sub) です。

MCPクライアント設定

例としてのクライアントエントリ (mcp.json) は以下の通りです。

{
  "servers": {
    "slack": {
      "url": "http://localhost:8000/mcp/slack",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_JWT"
      }
    }
  }
}

ユーザーがOAuthを完了していない場合、ツールの呼び出しは requires_auth: true と oauth_url を含むオブジェクトを返します。このURLを開いて認証を完了できます。

VS Code MCPクライアント設定

VS Codeのユーザー設定でこの mcp.json を使用します ( JWT を生成したトークンに置き換えてください)。

{
  "servers": {
    "slack": {
      "url": "http://localhost:8000/mcp/slack",
      "type": "http",
      "headers": {
        "Authorization": "Bearer JWT"
      }
    }
  },
  "inputs": []
}

LangChainの使用例

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

client = MultiServerMCPClient(
    {
        "slack": {
            "transport": "streamable_http",
            "url": "http://localhost:8000/mcp/slack",
            "headers": {
                "Authorization": "Bearer YOUR_TOKEN"
            },
        }
    }
)

tools = await client.get_tools()
agent = create_react_agent("openai:gpt-4.1", tools)
response = await agent.ainvoke({"messages": "Can you send hello message to my #general groups?"})

Dockerを使用した実行

以下のコマンドでDockerでバーナースペース (Bernerspace) MCPを実行できます。

docker build -t bernerspace-mcp .
docker run --env-file .env -p 8000:8000 bernerspace-mcp

📚 ドキュメント

すべてのセットアップ手順、統合ガイド、およびサンプルは、当社のNotionドキュメントに記載されています。

🔗 バーナースペース (Bernerspace) クイックスタートドキュメント

ドキュメントは定期的に更新され、以下の内容が含まれています。

• 新しい統合のクイックスタートガイド
• 段階的なインストール手順
• 各ツールの使用例
• ロードマップとコントリビューションガイドライン

🔧 技術詳細

現在の状態

• 現在稼働中の統合: Slack で47の完全にテストされたツールが利用可能。
  → Slackツールの詳細を学ぶ: docs/slack/tools.md
• 近日公開予定: Gmail、Googleカレンダー、および Notion。

データベース

• スキーマはAlembicで管理されています (マイグレーション含む)。
• テーブル: oauth_tokens(client_id, integration_type, token_json, stored_at)。
• DATABASE_URL を介してPostgresを構成します。

🚀 ロードマップ

私たちはまだ始まったばかりです。目標は 100以上の統合 をサポートし、あなたが任意のサードパーティサービスをMCPサーバーに簡単に接続できるようにすることです。

近日公開予定

• 📧 Gmail
• 📅 Googleカレンダー
• 📂 Googleドライブ
• 🗂️ Notion
• 💻 GitHub
• 💬 Discord
• 📊 Airtable
• 🔍 ElasticSearch
• 📝 Confluence

その他、数十の機能が今後追加予定です。

🤝 コントリビューション

私たちはあらゆる種類のコントリビューションを歓迎します — バグの修正、機能の提案、ドキュメントの改善、または単なるフィードバックの共有でも構いません。

コントリビュートする方法

• ⭐ リポジトリをスター してサポートを表明し、他の人にバーナースペース (Bernerspace) を発見させましょう。
• 🐛 バグを報告 して、私たちが迅速に修正できるようにしましょう。
• 💡 機能を要求 するか、改善案を提案しましょう。
• 🛠️ コードの変更、ドキュメントの更新、またはテストを含むプルリクエストを提出しましょう。

連絡を取り合おう

• 📧 ranga.sumit1999@gmail.com までメールで連絡してください。
• 🐦 Twitter (X) でフォローしてDMを送ってください: @SumitSandbox

初めてのコントリビューターでも、経験豊富な開発者でも、私たちはあなたからの声を聞き、協力したいと思っています！

📄 ライセンス

このプロジェクトは MITライセンス の下でライセンスされています。