MidOS Research Protocol
Protocolo de Investigación MidOS: habilidades y conocimiento curados y versionados.
Documentación
midos-mcp
MidOS MCP Community Library — 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 conocimiento de MidOS debe estar disponible localmente. Establece la variable de entorno MIDOS_ROOT para que apunte a tu 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
| Bandera | Transporte | Caso de uso |
|---|---|---|
--stdio | stdio | Claude Code, Cursor, Cline (predeterminado) |
--http | HTTP Streamable | Clientes web, acceso remoto |
--sse | Eventos enviados por el servidor | Clientes heredados |
midos-mcp config
Genera una configuración JSON lista para 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 conocimiento, 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 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 (gratis), pro ($10/mes), admin.
Configuración
Variables de Entorno
| Variable | Predeterminado | Descripción |
|---|---|---|
MIDOS_ROOT | detección automática | Ruta a la instalación de MidOS (requerida) |
MIDOS_HOST | 127.0.0.1 | Host de enlace del servidor HTTP |
MIDOS_PORT | 8419 | Puerto de enlace del servidor HTTP |
MIDOS_TRANSPORT | stdio | Transporte predeterminado |
Detección de Raíz
El servidor localiza la base de conocimiento de MidOS:
- Variable de entorno
MIDOS_ROOT(recomendada) - Detección automática: sube desde la ubicación del paquete buscando
CLAUDE.md+knowledge/ - Alternativa: directorio de trabajo actual
Si instalaste vía pip, la detección automática no encontrará la base de conocimiento. O bien:
# 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
| Cliente | Archivo de Configuración | Transporte |
|---|---|---|
| Claude Desktop | claude_desktop_config.json | stdio |
| Claude Code | .mcp.json | stdio |
| Cursor | .cursor/mcp.json | stdio |
| Cline | cline_mcp_settings.json | stdio |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | stdio |
| Continue.dev | ~/.continue/config.json | stdio |
| Zed | ~/.config/zed/settings.json | stdio |
| OpenCode | opencode.json | SSE |
Dependencias Opcionales
# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]
# Development tools
pip install midos-mcp[dev]
Qué Incluye
MidOS expone 68 herramientas MCP en 2 niveles:
| Nivel | Herramientas | Acceso |
|---|---|---|
| Dev | 34 herramientas | Gratis — sin necesidad de clave API, contenido completo, 500 consultas/mes |
| Pro | 68 herramientas | $10/mes — operaciones de seguridad, AOTC, orquestación, operaciones de escritura para creadores |
Capacidades
- Conocimiento — Busca más de 46K fragmentos seleccionados 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 mediante LanceDB + incrustaciones de Gemini (3072-d)
Límites de Tasa
| Nivel | Consultas/mes | Contenido |
|---|---|---|
| Dev | 500 | Contenido completo (sin truncamiento) |
| Pro | 100,000 | Contenido completo + AOTC + paquetes de operaciones |
Las claves API inválidas o caducadas vuelven silenciosamente al nivel Dev.
Requisitos
- Python 3.10+
- FastMCP 2.x
- Base de conocimiento de MidOS (local)
Licencia
MIT