mcp-server-toolkit

Kit de inicio para servidores del Protocolo de Contexto de Modelos (MCP) listos para producción con autenticación, trazabilidad y un sistema de plugins.

Creado por Sarma Linux.

Qué es esto

MCP pasó de ser una especificación de nicho a la capa de integración predeterminada a finales de 2025. Todo agente serio ahora lo utiliza. La mayoría de los servidores de referencia son juguetes: una sola herramienta, sin autenticación, sin observabilidad. Este kit de herramientas es la alternativa con todo incluido y opinión propia.

Crea la estructura de un servidor MCP con un solo comando. Coloca los manejadores de herramientas en un directorio de plugins. Obtén OAuth 2.1 con PKCE, registro estructurado, trazas de OpenTelemetry, limitación de tasa y un registro de herramientas tipado de forma gratuita. Se ejecuta sobre stdio para agentes locales y HTTP transmitible para los remotos, usando la misma ruta de código.

Arquitectura

graph TD
  Client[MCP Client<br/>Desktop / Cursor / IDE]
  Client -->|stdio JSON-RPC| Stdio[stdio transport]
  Client -->|streamable HTTP| HTTP[FastAPI HTTP transport]
  Stdio --> Reg[Tool Registry]
  HTTP --> Auth[OAuth 2.1 / API key]
  Auth --> Reg
  Reg --> P1[plugin: filesystem]
  Reg --> P2[plugin: postgres]
  Reg --> P3[plugin: github]
  Reg --> P4[plugin: sarmalink]
  P4 -->|api.sarmalink.ai| SLAI[SarmaLink-AI]

  classDef ext fill:#a78bfa,stroke:#a78bfa,color:#fff
  class SLAI ext

Inicio rápido

git clone https://github.com/sarmakska/mcp-server-toolkit.git
cd mcp-server-toolkit
uv sync
cp .env.example .env
uv run mcp-toolkit run --transport stdio

Creación de plugins

from mcp_toolkit.registry import registry

@registry.tool("search_docs", description="Search internal docs")
async def search_docs(query: str) -> dict:
    return {"results": [...]}

Configuración

Despliegue

Imagen Docker Distroless, ~120MB. Se ejecuta en Fly.io, Render, Railway, k8s.

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

Hoja de ruta

Consulta docs/OPEN-ISSUES.md. Las solicitudes de extracción (PRs) son bienvenidas.

Licencia

MIT.

Creado por Sarma Linux.