Servidor MCP : docmd docs

Referencia
Servidor MCP

docmd incorpora un servidor nativo del Protocolo de Contexto de Modelo (MCP), lo que permite a los agentes de desarrollo de IA interactuar con su espacio de trabajo de documentación mediante programación a través de canales de transporte locales.

Descripción técnica

El Protocolo de Contexto de Modelo es una especificación abierta para conectar modelos de IA con herramientas del espacio de trabajo local. docmd implementa la capa de transporte stdio: los clientes inician docmd mcp como un subproceso e intercambian mensajes JSON-RPC 2.0 a través de los flujos de entrada/salida estándar.

Inicio y configuración

docmd mcp

Integración con Claude Desktop

Agregue a su claude_desktop_config.json:

claude_desktop_config.json

{
  "mcpServers": {
    "docmd": {
      "command": "npx",
      "args": ["@docmd/core", "mcp"],
      "cwd": "/path/to/your/docs/project"
    }
  }
}

Configuración en Cursor e IDE

Configure en el panel de ajustes de MCP del editor:

mcp_settings.json

{
  "command": "npx @docmd/core mcp",
  "transport": "stdio"
}

Herramientas disponibles

El servidor MCP expone 6 controladores de herramientas principales:

Herramienta	Propósito técnico
`search_docs`	Ejecutar consultas de búsqueda de texto completo en archivos fuente Markdown. Devuelve ubicaciones de archivos y números de línea coincidentes.
`list_docs`	Enumerar rutas relativas de archivos Markdown dentro del espacio de trabajo (opcionalmente delimitadas por subdirectorios).
`read_doc`	Leer el contenido fuente Markdown sin procesar para las rutas de archivo especificadas. El acceso está estrictamente aislado a las raíces del proyecto.
`get_config`	Inspeccionar los parámetros de configuración resueltos (`docmd.config.json`). Las claves sensibles (tokens de API, ID secretos) se redactan automáticamente.
`validate_docs`	Ejecutar comprobaciones de validación de enlaces en las fuentes Markdown. Devuelve informes de enlaces rotos con ubicaciones de destino.
`get_llms_context`	Obtener cargas útiles de contexto `llms-full.txt` unificadas y optimizadas para la ingestión de indicaciones de LLM.

Detalles de cumplimiento del protocolo

docmd admite la especificación MCP estándar:

Mecanismo de transporte: stdio (mensajes JSON-RPC 2.0 a través de E/S estándar).
Registro: Registros de diagnóstico fuera de banda emitidos a través de stderr.
Flujo del ciclo de vida: initialize → notifications/initialized → Invocaciones de herramientas.
Capacidades: Expone tools, resources y prompts.

Controles de seguridad

Aislamiento de procesos locales: Opera estrictamente como un proceso secundario sin abrir puertos de red externos.
Verificación de límites de ruta: Las operaciones de E/S de archivos están restringidas dentro del directorio raíz del proyecto.

Uso de MCP frente a llms.txt

Utilice MCP cuando los agentes de IA necesiten acceso interactivo a herramientas para buscar archivos o validar enlaces durante la edición de código. Utilice llms-full.txt al entregar cargas útiles completas de contexto del sitio en operaciones de una sola indicación.