midos-mcp

Biblioteca Comunitaria MidOS MCP — Conocimiento, habilidades e investigación como herramientas MCP.

Instala una vez, conéctate a cualquier cliente de IA.

Instalación

pip install midos-mcp

Requisito: La base de conocimientos de MidOS debe estar disponible localmente. Establece la variable de entorno MIDOS_ROOT para que apunte al directorio de instalación de MidOS (el que contiene knowledge/ y modules/).

export MIDOS_ROOT=/path/to/midos

Inicio rápido

# Start server (stdio — default for Claude Code, Cursor, etc.)
midos-mcp serve

# Start with HTTP transport
midos-mcp serve --http

# Generate config for your AI client
midos-mcp config --generate claude
midos-mcp config --generate cursor

# Check health
midos-mcp health

Comandos

midos-mcp serve

Inicia el servidor MCP con tu transporte preferido.

midos-mcp serve              # stdio (default)
midos-mcp serve --http       # Streamable HTTP on 127.0.0.1:8419
midos-mcp serve --sse        # Legacy SSE transport
midos-mcp serve --http --host 0.0.0.0 --port 9000

midos-mcp config

Genera una configuración JSON lista para copiar y pegar para cualquier cliente MCP compatible.

midos-mcp config --generate claude    # Claude Desktop / Claude Code
midos-mcp config --generate cursor    # Cursor IDE
midos-mcp config --generate cline     # Cline (VS Code)
midos-mcp config --generate windsurf  # Windsurf IDE
midos-mcp config --generate continue  # Continue.dev
midos-mcp config --generate zed       # Zed Editor
midos-mcp config --generate opencode  # OpenCode
midos-mcp config --generate http      # Generic HTTP client

# Write to file
midos-mcp config --generate claude -o mcp-config.json

midos-mcp health

Comprueba el estado del servidor: estadísticas de la base de conocimientos, estado del almacén de vectores, dependencias.

midos-mcp health          # Human-readable output
midos-mcp health --json   # JSON output for scripts

midos-mcp keys

Gestiona claves API para el control de acceso por niveles.

midos-mcp keys generate --name "my-app" --tier dev
midos-mcp keys list
midos-mcp keys revoke midos_sk_abc

Niveles: dev (gratuito), pro ($10/mes), admin.

Configuración

Variables de entorno

Detección de raíz

El servidor localiza la base de conocimientos de MidOS:

1. Variable de entorno MIDOS_ROOT (recomendado)

2. Detección automática: sube desde la ubicación del paquete buscando CLAUDE.md + knowledge/

3. Alternativa: directorio de trabajo actual

Si instalaste a través de pip, la detección automática no encontrará la base de conocimientos. Haz una de las siguientes opciones:

# Option A: Clone the repo and point to it
git clone https://github.com/MidOSresearch/midos.git
export MIDOS_ROOT=./midos

# Option B: Point to an existing MidOS directory
export MIDOS_ROOT=/path/to/your/midos

Verifica con midos-mcp health: muestra la raíz detectada y los recuentos de conocimiento.

Clientes compatibles

Dependencias opcionales

# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]

# Development tools
pip install midos-mcp[dev]

Qué hay dentro

MidOS expone 68 herramientas MCP en 2 niveles:

Capacidades

• Conocimiento — Busca en más de 46K fragmentos curados en todos los dominios (contenido completo, sin truncamiento)

• Habilidades — 119 patrones reutilizables en más de 16 stacks tecnológicos

• EUREKA — 383 mejoras validadas con ROI medido

• Verdad — 50 parches y correcciones verificados

• SOTA — 140 techos de convergencia de última generación

• Búsqueda vectorial — Búsqueda semántica a través de LanceDB + embeddings de Gemini (3072-d)

Límites de tasa

Las claves API no válidas o caducadas vuelven silenciosamente al nivel Dev.

Requisitos

• Python 3.10+

• FastMCP 2.x

• Base de conocimientos de MidOS (local)

Licencia

MIT