convez.ai
MCP Server
BigFatDot

BigMCP

BigFatDot/BigMCP

Ver no GitHub
BomPluginScore · de 0 a 100

Multi-tenant MCP Gateway - Connect AI assistants to 180+ MCP servers via Model Context Protocol

Instalação

$npx convez-ai BigFatDot/BigMCP

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
2
Saúde
75%
Último commit
há 5 meses
Versão
v2.0.0
Issues abertas
1
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.


Full documentation: bigfatdot.github.io/bigmcp — quickstart, self-hosting, curation, ops runbook, API reference, ADRs.


Quick Start

git clone https://github.com/bigfatdot/bigmcp.git
cd bigmcp
cp .env.example .env
# Edit .env with your secrets (SECRET_KEY, ENCRYPTION_KEY)
docker compose up -d
docker compose exec backend alembic upgrade head

Open http://localhost — the first user to register becomes instance admin (Community / Enterprise edition).

Want to try it first? bigmcp.cloud is a free demo platform.

Connect Claude Desktop

{
  "mcpServers": {
    "bigmcp": {
      "url": "https://your-domain.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Why BigMCP

BigMCP is the control plane for all your MCP servers — the 180+ from the marketplace AND your own custom servers.

Without BigMCPWith BigMCP
Install MCP servers on each deviceOne endpoint — access all tools
Configure credentials separatelyCentralized credentials — User + Org + Server
No access controlRBAC — Owner, Admin, Member, Viewer
No visibility into usageAudit logs — who used what, when
Manual setup per teamTool Groups + API Keys — selective service exposure

For Organizations

The core use case: register your internal MCP servers, create Tool Groups per team, generate scoped API Keys, and let each team member connect their AI client with a single URL.

  1. Register your servers — npm, pip, Docker, HTTP, or local binary
  2. Auto-discover tools — BigMCP calls tools/list and indexes everything
  3. Create Tool Groups — "Dev Team" gets GitHub + CI/CD, "Finance" gets Grist + DB queries
  4. Generate API Keys — scoped per Tool Group, with granular permissions
  5. Connect — each user pastes one URL in Claude/Cursor and sees only their tools

Features

Custom MCP Server Management

  • Register servers from any source: npm, pip, GitHub, Docker, HTTP URL, local binary
  • Auto-discovery via tools/list — tools are indexed automatically
  • Closed mode: instance admin can disable each marketplace source individually via /api/v1/admin/sources/{source_id} so a hardened deploy can run with custom servers only
  • Team vs Personal servers with granular visibility

Selective Service Exposure

  • Tool Groups — curated sets of tools with PRIVATE / ORGANIZATION / PUBLIC visibility
  • Scoped API Keys — 7 granular scopes (tools:read, tools:execute, credentials:read/write, servers:read/write, admin)
  • Per-Tool Group API Keys — each key only exposes the tools you choose
  • Usage tracking — per tool, per server, per key

Authentication & Security

  • OAuth 2.0 + PKCE (RFC 7636) with Dynamic Client Registration
  • JWT tokens with configurable expiration
  • API Keys for programmatic access (bcrypt hashed, mcphub_sk_* format)
  • MFA / TOTP two-factor authentication
  • Credentials encrypted at rest (Fernet)
  • Immutable audit logs with HMAC-SHA256 signatures

Multi-Tenant Architecture

  • Organization-based isolation with RBAC
  • 4-tier roles: Owner, Admin, Member, Viewer
  • Hierarchical credentials: User > Organization > Server
  • Unlimited users and organizations

Dynamic Marketplace

  • 180+ MCP servers from npm, GitHub, Glama.ai, Smithery.ai
  • Semantic search with vector embeddings
  • One-click installation with credential detection
  • Marketplace can be fully disabled for closed environments

Marketplace Curation (CUR-1)

LLM-facing curation layer shipped in-repo so every BigMCP instance benefits without having to re-curate the catalog locally.

  • mcp-registry/conf/curated_overlays.json — 10 servers, 18 tools curated end-to-end: canonical EN descriptions, normalised input_schema_canonical, param_aliases, MCP 2025-06-18 annotations (readOnlyHint/destructiveHint/idempotentHint/openWorldHint), per-tool examples, risk_level, server-level safety_summary, tier.
  • mcp-registry/conf/translations/fr.json — French sidecar (12 servers, ~75 tools). Other locales can be added via conf/translations_overrides/<lang>.json per instance.
  • mcp-registry/scripts/translate_catalog.py — Mistral-driven CLI to scale the FR sidecar to other languages (--dry-run, --merge, --force, --servers a,b,c).
  • Measured impact on the Mistral eval baseline (20 tasks): param_accuracy 45 % → 90 % (+45 pts) — no regression on accuracy or completion_rate.
  • CI gate: MARKETPLACE_STRICT_CATALOG=true validates the shipped catalog + overlays at boot.

AI Orchestration & Durable Workflows

  • Intent analysis — Natural language to workflow
  • Composition lifecycle — temporary → validated → production; promoted compositions become first-class MCP tools
  • 5 suspending step types that survive crashes & restarts (Phase B-1):
    • elicit — pause for human input mid-flight
    • wait_until — clock-driven resume at a future timestamp
    • wait_callback — HMAC-protected webhook resume (external systems POST back)
    • subcomposition — call another composition; parent suspends until child terminates
    • approval — cross-user gate with four-eyes default, role + user_id approver list
  • Resumable executor persists every step in Postgres; clients subscribe to composition://executions/{id} for live updates

MCP Protocol Compliance

  • MCP 2025-06-18 — Streamable HTTP + SSE
  • OAuth 2.0 authorization for MCP clients
  • Works with Claude Desktop, Cursor, Continue.dev, Cline, and any MCP-compatible client

Architecture

+-----------------------------------------------------------------+
|                      CLIENT INTERFACES                           |
+------------------+-----------------+-----------------------------+
|  MCP Protocol    |   REST API v1   |    OAuth 2.0 Clients        |
|  (SSE/JSON-RPC)  |     (JSON)      |  (Claude Desktop, etc.)     |
+--------+---------+--------+--------+--------------+--------------+
         |                  |                       |
         +------------------+-----------------------+
                            v
+-----------------------------------------------------------------+
|                   GATEWAY LAYER (FastAPI)                         |
|  Authentication - Authorization - Rate Limiting - Routing        |
+-----------------------------------------------------------------+
                            |
                            v
+-----------------------------------------------------------------+
|                  ORCHESTRATION LAYER                              |
|  Semantic Search - Intent Analysis - Workflow Composition         |
|  Credential Resolution - Permission Checks                       |
+-----------------------------------------------------------------+
                            |
                            v
+-----------------------------------------------------------------+
|                 REGISTRY & MARKETPLACE                            |
|  Tool Catalog - User Server Pools - Health Monitoring             |
+-----------------------------------------------------------------+
                            |
                            v
+-----------------------------------------------------------------+
|                    MCP SERVERS                                    |
|  your-custom-api | github-mcp | notion-mcp | [marketplace]       |
+-----------------------------------------------------------------+
                            |
                            v
+-----------------------------------------------------------------+
|                    DATABASE LAYER                                 |
|  PostgreSQL 16 - Redis 7 - Qdrant                                |
+-----------------------------------------------------------------+

Self-Hosted Deployment

Requirements

  • Docker & Docker Compose
  • 2GB RAM minimum
  • PostgreSQL 16 (included in compose)

Production Deploy

# 1. Clone
git clone https://github.com/bigfatdot/bigmcp.git
cd bigmcp

# 2. Configure
cp .env.example .env
# Generate secrets:
python3 -c "import secrets; print(secrets.token_urlsafe(32))"       # SECRET_KEY
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"  # ENCRYPTION_KEY

# 3. Start
docker compose up -d

# 4. Initialize database
docker compose exec backend alembic upgrade head

# 5. Access at http://localhost (nginx serves the frontend on port 80)

Environment Variables

# Required
SECRET_KEY=your-secret-key-min-32-chars
ENCRYPTION_KEY=your-fernet-key
DATABASE_URL=postgresql+asyncpg://mcphub:mcphub@postgres:5432/mcphub

# Optional — LLM provider (Bring Your Own LLM)
# Any OpenAI-compatible /chat/completions endpoint. Tested: Mistral, OpenAI,
# Ollama, vLLM. Anthropic NOT supported here (non-OpenAI-compatible API).
LLM_API_URL=https://api.mistral.ai/v1
LLM_API_KEY=your-api-key
LLM_MODEL=mistral-small-latest
EMBEDDING_MODEL=mistral-embed
EMBEDDING_DIMENSION=1536       # 1024 for mistral-embed, 768 for nomic-embed
RERANK_ENABLED=false           # Mistral-only feature; leave off for portability

# Optional — Air-gap mode (no outbound HTTP except your LLM)
AIRGAP_MODE=false              # true disables marketplace sync + icon CDN + LemonSqueezy

# Optional — SMTP for email invitations
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=your-email
SMTP_PASSWORD=your-password

Run fully offline with a local LLM

# Example: BigMCP + Ollama, zero outbound traffic
LLM_API_URL=http://ollama:11434/v1
LLM_MODEL=llama3.1
EMBEDDING_MODEL=nomic-embed-text
EMBEDDING_DIMENSION=768
AIRGAP_MODE=true

Monitoring

  • GET /health — Liveness probe
  • GET /ready — Readiness probe (DB + registry + cache)
  • GET /metrics — Prometheus endpoint

Technology Stack

LayerTechnologies
BackendFastAPI, Python 3.11+, SQLAlchemy 2.0, Alembic
DatabasePostgreSQL 16, Redis 7, Qdrant
SecurityJWT, bcrypt, Fernet encryption, OAuth 2.0 + PKCE, MFA/TOTP
FrontendReact 18, TypeScript, Tailwind CSS, Vite
InfrastructureDocker Compose, Uvicorn, Nginx
MonitoringPrometheus metrics
ProtocolsMCP 2025-06-18, SSE, JSON-RPC 2.0

Documentation

ResourceDescription
Documentation siteFull guides — quickstart, self-hosting, curation, ops runbook, ADRs
API Reference (Swagger)OpenAPI/Swagger (also at /docs on your instance)
ChangelogVersion history
ContributingHow to contribute
LicensingAGPLv3 license details
Self-Hosting guideDocker, TLS, Postgres, BYOL — in the doc site
Ops runbookBackup, restore, key rotation, monitoring

Contributing

We welcome contributions! See CONTRIBUTING.md.

# Development setup
cd mcp-registry
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt

# Run tests
pytest tests/ -v

# Start dev server
uvicorn app.main:app --reload --port 8001

License

BigMCP is licensed under the GNU Affero General Public License v3.0 (AGPLv3).

All features are included. No user limits. No license keys.

See LICENSING.md for details.


Support

ChannelDescription
GitHub IssuesBug reports & feature requests
DocumentationGuides and API reference
EmailGeneral inquiries

Ver o original no GitHub

Bom para

Relacionados