Content
# Bernerspace
### One MCP server · All your integrations · Zero hassle
[](https://github.com/bernerspace/bernerspace/stargazers)
[](https://github.com/bernerspace/bernerspace/issues)
[](LICENSE)
[](https://www.notion.so/sumitsandbox/Bernerspace-quick-start-24be21126afc80d3b765dd75556e6e50)
[](mailto:sumit@example.com)
<p align="center">
<img src="assets/banner.jpg" alt="Bernerspace Banner" width="800">
</p>
<p align="center">
🚀 <b>Unified MCP server for all OAuth-enabled integrations</b><br>
<i>One server · One JWT · Many tools</i>
</p>
<p align="center">
✅ <b>Current Live Integration:</b> Slack — <b>47 tools</b> tested & available <br>
🔜 <b>Coming Soon:</b> Gmail · Google Calendar · Notion <br>
🎯 <b>Goal:</b> 100+ integrations
</p>
## Why
Using or integrating MCP servers today is painful because:
- Most MCP servers lack OAuth capabilities, limiting user experience.
- Every MCP server requires separate deployment and management, increasing operational overhead.
- Integration chaos: different authentication layers across MCP servers make unified integration nearly impossible.
## What You Get
- Single JWT across services via middleware (HS256 or RS256 via JWKS; issuer/audience validated).
- OAuth middleware per integration (Slack live; more coming) with DB‑backed token storage.
- Consistent MCP tools interface for each service.
- Unified endpoints you can self‑host, e.g.:
- <http://localhost:8000/slack>
- <http://localhost:8000/gmail> (coming soon)
## Current Status
- Current live integration: **Slack** with 47 fully tested tools available.
→ Learn more about Slack tools: [docs/slack/tools.md](docs/slack/tools.md)
- Coming soon: **Gmail**, **Google Calendar**, and **Notion**.
## 📖 Documentation
All setup instructions, integration guides, and examples are available on our Notion docs:
🔗 **[Bernerspace Quick Start Docs](https://www.notion.so/sumitsandbox/Bernerspace-quick-start-24be21126afc80d3b765dd75556e6e50)**
The docs are updated regularly with:
- Quick start guides for new integrations
- Step-by-step installation instructions
- Usage examples for each tool
- Roadmap and contribution guidelines
## Quickstart
1. Environment
Create a `.env` (see `.env.example`) with the following variables:
```bash
# Database
DATABASE_URL=postgresql://localhost:5432/mcp_server
# Auth (choose one)
# Option A: HS256
JWT_SECRET=your-jwt-signing-secret
# Option B: RS256 via JWKS
# JWT_JWKS_URL=https://your-auth-domain/.well-known/jwks.json
# JWT_ISSUER=https://your-auth-domain/
# JWT_AUDIENCE=my-api
# Slack OAuth
SLACK_CLIENT_ID=<slack_client_id>
SLACK_CLIENT_SECRET=<slack_client_secret>
SLACK_REDIRECT_URI=http://localhost:8000/slack/oauth/callback
# Optional: encrypt tokens at rest (comma-separated MultiFernet keys)
# TOKEN_ENCRYPTION_KEYS=
```
1. Install dependencies (choose one)
- Using pip
- python3 -m venv .venv && source .venv/bin/activate
- pip install -e .
- Using uv
- uv venv && source .venv/bin/activate
- uv pip install -e .
1. Run the server
- Using Python
- python server.py
- Server will listen on <http://localhost:8000>
- Using Docker
- docker build -t bernerspace-mcp .
- docker run --env-file .env -p 8000:8000 bernerspace-mcp
- Server will listen on <http://localhost:8000>
- Using Docker Compose
- docker compose up -d
1. Create a JWT to call the MCP server
- python generate_jwt.py --user-id <your_user_id>
- Use the printed token as: Authorization: Bearer TOKEN
## OAuth Flow (Slack)
- GET /slack returns `oauth_url` and instructions to authorize the workspace.
- Slack redirects to `SLACK_REDIRECT_URI` (defaults to `/slack/oauth/callback`).
- The server exchanges the code, enriches the token details, and persists it in Postgres.
- Tokens are stored in table `oauth_tokens` with composite key `(client_id, integration_type)` where `client_id` = your JWT subject (`sub`).
## Database
- Schema managed with Alembic (migrations included).
- Table: `oauth_tokens(client_id, integration_type, token_json, stored_at)`.
- Configure Postgres via `DATABASE_URL`.
- Tokens can be encrypted at rest when `TOKEN_ENCRYPTION_KEYS` is set.
## MCP Client Configuration
Example client entry (mcp.json):
```json
{
"servers": {
"slack": {
"url": "http://localhost:8000/mcp/slack",
"type": "http",
"headers": {
"Authorization": "Bearer YOUR_JWT"
}
}
}
}
```
If the user hasn’t completed OAuth, tool calls will return an object with `requires_auth: true` and an `oauth_url` you can open to complete authorization.
## VS Code MCP Client Setup
Use this `mcp.json` in your VS Code user settings (replace `JWT` with your generated token):
```json
{
"servers": {
"slack": {
"url": "http://localhost:8000/mcp/slack",
"type": "http",
"headers": {
"Authorization": "Bearer JWT"
}
}
},
"inputs": []
}
```
## LangChain Example
```python
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
You can run Bernerspace MCP in Docker:
```bash
docker build -t bernerspace-mcp .
docker run --env-file .env -p 8000:8000 bernerspace-mcp
```
## 🚀 Roadmap
We’re just getting started. Our goal is to support **100+ integrations** so you can connect any third-party service to your MCP server with ease.
### Coming Soon
- 📧 Gmail
- 📅 Google Calendar
- 📂 Google Drive
- 🗂️ Notion
- 💻 GitHub
- 💬 Discord
- 📊 Airtable
- 🔍 ElasticSearch
- 📝 Confluence
…and dozens more on the way.
## 🤝 Contributing
We welcome contributions of all kinds — whether it’s fixing a bug, suggesting a feature, improving documentation, or just sharing feedback.
### Ways to Contribute
- ⭐ **Star the repo** to show your support and help others discover Bernerspace.
- 🐛 [Report a bug](https://github.com/bernerspace/bernerspace/issues/new/choose) so we can fix it quickly.
- 💡 [Request a feature](https://github.com/bernerspace/bernerspace/issues/new/choose) or suggest an improvement.
- 🛠️ Submit a Pull Request with code changes, docs updates, or tests.
### Stay in Touch
- 📧 Email me at [ranga.sumit1999@gmail.com](mailto:ranga.sumit1999@gmail.com)
- 🐦 Follow & DM on Twitter (X): [@SumitSandbox](https://x.com/SumitSandbox)
Whether you’re a first-time contributor or an experienced developer, we’d love to hear from you and collaborate!
## License
This project is licensed under the [MIT License](LICENSE).
