Bernerspace

🚀 伯納斯空間（Bernerspace）

伯納斯空間是一個統一的MCP服務器，支持所有啟用OAuth的集成服務。它解決了當前MCP服務器使用和集成過程中的痛點，只需一個服務器、一個JWT，就能輕鬆集成多種工具，為用戶提供便捷的使用體驗。

🚀 用於所有支持OAuth集成的統一MCP服務器
一個服務器 · 一個JWT · 多種工具

✅ 當前即時集成：Slack — 47個工具 已測試並可用
🔜 即將推出： Gmail · Google日曆 · Notion
🎯 目標： 100+ 集成

🚀 快速開始

1. 環境配置

創建一個 .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

2. 安裝依賴（二選一）

• 使用pip

  python3 -m venv .venv && source .venv/bin/activate
  pip install -e .
  

• 使用uv

  uv venv && source .venv/bin/activate
  uv pip install -e .
  

3. 運行服務器

• 使用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
  

4. 創建JWT以調用MCP服務器

python generate_jwt.py --user-id <your_user_id>

使用打印出的令牌作為：Authorization: Bearer TOKEN

✨ 主要特性

解決痛點

目前使用或集成MCP服務器存在諸多痛點，而伯納斯空間有效解決了這些問題：

• 大多數MCP服務器缺乏OAuth功能，限制了用戶體驗。伯納斯空間具備完善的OAuth中間件，為用戶提供更好的使用體驗。
• 每個MCP服務器都需要單獨部署和管理，增加了運營成本。伯納斯空間實現了統一部署和管理，降低了運營成本。
• 集成混亂：不同MCP服務器的認證層不同，使得統一集成幾乎不可能。伯納斯空間提供了一致的MCP工具接口，實現了統一集成。

功能優勢

• 通過中間件在服務間使用單個JWT（HS256，驗證發行者/受眾）。
• 每個集成都有OAuth中間件（Slack已上線；更多即將推出），並使用數據庫支持的令牌存儲。
• 為每個服務提供一致的MCP工具接口。
• 提供可自託管的統一端點，例如：
  • http://localhost:8000/mcp/slack
  • http://localhost:8000/mcp/gmail（即將推出）

📦 安裝指南

安裝步驟請參考快速開始部分。

💻 使用示例

基礎用法

VS Code 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?"})

📚 詳細文檔

所有設置說明、集成指南和示例都可以在我們的Notion文檔中找到： 🔗 伯納斯空間快速入門文檔

文檔會定期更新，包含以下內容：

• 新集成的快速入門指南
• 分步安裝說明
• 每個工具的使用示例
• 路線圖和貢獻指南

🔧 技術細節

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)。

數據庫

• 使用Alembic管理架構（包含遷移）。
• 表：oauth_tokens(client_id, integration_type, token_json, stored_at)。
• 通過 DATABASE_URL 配置Postgres。

📄 許可證

本項目採用 MIT許可證 進行許可。