MCQuest MCP — Servidor de inteligencia de proyectos de solo lectura

Un servidor MCP de solo lectura y reutilizable para dar a los agentes de código de IA acceso estructurado al código fuente y a la arquitectura de un proyecto de software.

Desarrollado originalmente para MCQuest, el servidor se mantiene a propósito como una herramienta independiente para desarrolladores, fuera de los repositorios de la aplicación.

Puede reutilizarse en diferentes proyectos.

Funciones

La versión actual (v0.2) proporciona 16 herramientas de solo lectura organizadas en categorías:

Estructura del proyecto

Análisis de código fuente

Inteligencia documental

Evidencia cruzada y Git

El servidor no modifica el proyecto de destino.

Related MCP server: reflens

Conocimiento de la documentación

Las herramientas de documentación dan al agente de IA acceso de solo lectura a la documentación Markdown del proyecto (p. ej. docs/, memory-bank/), incluidas las fases anteriores de auditoría e implementación.

• mcquest_list_docs — lista archivos Markdown en una ruta relativa al proyecto.

• mcquest_read_doc — lee un archivo Markdown con números de línea exactos.

• mcquest_search_docs — busca por expresión regular o texto en los documentos Markdown y devuelve la ruta del archivo, el número de línea, la línea coincidente y el contexto circundante.

• mcquest_phase_context — Dos modos: modo query (texto libre: "responsive overflow", "Android") y modo phase (consulta estructurada: phase="61"). El modo phase devuelve resultados agrupados por tipo de documento.

Estas herramientas conservan la evidencia de Markdown original y las referencias de línea. No resumen, reescriben ni interpretan la documentación; devuelven la evidencia en bruto para que el agente pueda razonar sobre ella.

Las herramientas distinguen entre hechos documentados, trabajo completado, hallazgos de auditoría, recomendaciones, problemas no resueltos y hallazgos explícitamente no verificados/estáticos, conservando el texto original y las referencias de línea. Nunca convierten un hallazgo no verificado/estático en un hecho verificado.

Seguridad

Este MCP es intencionadamente de solo lectura.

No incluye:

• edición de archivos

• creación de archivos

• eliminación de archivos

• ejecución de shell

• ejecución de código arbitrario

• instalación de paquetes

• mutación de Git

• commits

• pushes

• despliegue

El servidor está diseñado para proporcionar evidencia, mientras que el agente de codificación de IA realiza el razonamiento.

Flujo de uso recomendado con Cline

1. mcquest_project — Primera llamada para orientarse en el proyecto

2. mcquest_phase_context(phase="N") — Comprender una fase concreta

3. mcquest_find_evidence(query="...") — Búsqueda cruzada de código + documentación

4. mcquest_read_file / mcquest_read_doc — Leer archivos concretos

5. mcquest_git_context — Comprobar los cambios recientes antes de investigar

6. mcquest_compare_phase(from_phase="61", to_phase="62") — Comparar fases

Historial de versiones

• v0.2.0 — Se añadieron project_context, find_evidence, git_context y compare_phase. Se mejoraron todas las descripciones de las herramientas. Se añadió el parámetro phase a phase_context con una consulta estructurada agrupada por tipo de documento.

• v0.1.0 — Versión inicial con 12 herramientas de solo lectura.

Requisitos

• Windows, macOS o Linux

• Python 3.10+

• uv

• MCP Python SDK

• Node.js solo si se usa MCP Inspector

Instalación

Clona o coloca el servidor fuera de los repositorios de tu aplicación.

Ejemplo:

D:\DeveloperTools\mcquest-mcp