Skip to main content
Glama
noopstudios

Interactive Feedback MCP

by noopstudios

Retroalimentación interactiva MCP

Desarrollado por Fábio Ferreira ( @fabiomlferreira ). Visite dotcursorrules.com para obtener más mejoras en el desarrollo de IA.

Servidor MCP simple que permite un flujo de trabajo con intervención humana en herramientas de desarrollo asistidas por IA como Cursor . Este servidor permite ejecutar comandos, visualizar su resultado y proporcionar retroalimentación textual directamente a la IA. También es compatible con Cline y Windsurf .

Interfaz de usuario de retroalimentación interactiva - Vista principalInterfaz de usuario de retroalimentación interactiva: sección de comandos abierta

Ingeniería rápida

Para obtener los mejores resultados, agregue lo siguiente a su mensaje personalizado en su asistente de IA; debe agregarlo en una regla o directamente en el mensaje (por ejemplo, Cursor):

Siempre que quieras hacer una pregunta, llama al MCP interactive_feedback .
Cuando esté a punto de completar una solicitud de usuario, llame al MCP interactive_feedback en lugar de simplemente finalizar el proceso. Si el feedback está vacío, puede finalizar la solicitud y no llamar al MCP en bucle.

Esto garantizará que su asistente de IA utilice este servidor MCP para solicitar comentarios del usuario antes de marcar la tarea como completada.

Related MCP server: Spec-driven Development MCP Server

💡¿Por qué usar esto?

Al guiar al asistente para que se comunique con el usuario en lugar de recurrir a llamadas a herramientas especulativas y costosas, este módulo puede reducir drásticamente el número de solicitudes premium (por ejemplo, invocaciones de herramientas de OpenAI) en plataformas como Cursor. En algunos casos, ayuda a consolidar hasta 25 llamadas a herramientas en una sola solicitud que responde a la retroalimentación, lo que ahorra recursos y mejora el rendimiento.

Configuración

Este servidor MCP utiliza QSettings de Qt para almacenar la configuración por proyecto. Esto incluye:

  • El comando a ejecutar.

  • Si desea ejecutar el comando automáticamente en el próximo inicio de ese proyecto (consulte la casilla de verificación "Ejecutar automáticamente en la próxima ejecución").

  • El estado de visibilidad (mostrado/oculto) de la sección de comando (esto se guarda inmediatamente cuando se alterna).

  • Geometría y estado de la ventana (preferencias generales de UI).

Estas configuraciones generalmente se almacenan en ubicaciones específicas de la plataforma (por ejemplo, registro en Windows, archivos plist en macOS, archivos de configuración en ~/.config o ~/.local/share en Linux) bajo un nombre de organización "FabioFerreira" y un nombre de aplicación "InteractiveFeedbackMCP", con un grupo único para cada directorio de proyecto.

El botón "Guardar configuración" de la interfaz de usuario guarda principalmente el comando actual introducido en el campo de entrada de comandos y el estado de la casilla "Ejecutar automáticamente en la próxima ejecución" del proyecto activo. La visibilidad de la sección de comandos se guarda automáticamente al activarla. El tamaño y la posición general de la ventana se guardan al cerrar la aplicación.

Instalación (Cursor)

Instalación en Cursor

  1. Prerrequisitos:

    • Python 3.11 o más reciente.

    • uv (gestor de paquetes de Python). Instálelo con:

      • Windows: pip install uv

      • Linux/Mac: curl -LsSf https://astral.sh/uv/install.sh | sh

  2. Obtener el código:

    • Clona este repositorio: git clone https://github.com/noopstudios/interactive-feedback-mcp.git

    • O descargue el código fuente.

  3. Navegar al directorio:

    • cd path/to/interactive-feedback-mcp

  4. Instalar dependencias:

    • uv sync (esto crea un entorno virtual e instala paquetes)

  5. Ejecute el servidor MCP:

    • uv run server.py

  6. Configurar en Cursor:

    • Cursor suele permitir especificar servidores MCP personalizados en su configuración. Deberá apuntar Cursor a este servidor en ejecución. El mecanismo exacto puede variar, así que consulte la documentación de Cursor para agregar MCP personalizados.

    • Configuración manual (por ejemplo, a través de mcp.json ) Recuerde cambiar la ruta /Users/fabioferreira/Dev/scripts/interactive-feedback-mcp a la ruta real donde clonó el repositorio en su sistema.

      {
        "mcpServers": {
          "interactive-feedback-mcp": {
            "command": "uv",
            "args": [
              "--directory",
              "/Users/fabioferreira/Dev/scripts/interactive-feedback-mcp",
              "run",
              "server.py"
            ],
            "timeout": 600,
            "autoApprove": [
              "interactive_feedback"
            ]
          }
        }
      }
    • Puede utilizar un identificador de servidor como interactive-feedback-mcp al configurarlo en Cursor.

Para Cline / Windsurf

Se aplican principios de configuración similares. Debe configurar el comando del servidor (p. ej., uv run server.py con el argumento --directory correcto que apunta al directorio del proyecto) en la configuración de MCP de la herramienta correspondiente, utilizando interactive-feedback-mcp como identificador del servidor.

Desarrollo

Para ejecutar el servidor en modo de desarrollo con una interfaz web para realizar pruebas:

uv run fastmcp dev server.py

Esto abrirá una interfaz web y le permitirá interactuar con las herramientas MCP para realizar pruebas.

Herramientas disponibles

A continuación se muestra un ejemplo de cómo el asistente de IA llamaría a la herramienta interactive_feedback :

<use_mcp_tool>
  <server_name>interactive-feedback-mcp</server_name>
  <tool_name>interactive_feedback</tool_name>
  <arguments>
    {
      "project_directory": "/path/to/your/project",
      "summary": "I've implemented the changes you requested and refactored the main module."
    }
  </arguments>
</use_mcp_tool>

Agradecimientos y contacto

Si encuentra útil este MCP de retroalimentación interactiva, la mejor manera de mostrar su agradecimiento es seguir a Fábio Ferreira en X @fabiomlferreira .

Si tienes alguna pregunta, sugerencia o simplemente quieres compartir cómo lo usas, ¡no dudes en comunicarte con nosotros en X!

Además, visita dotcursorrules.com para obtener más recursos sobre cómo mejorar tu flujo de trabajo de desarrollo asistido por IA.

Available Tools

1 tool
interactive_feedbackB

Request interactive feedback for a given project directory and summary

ParametersJSON Schema
NameRequiredDescriptionDefault
project_directoryYesFull path to the project directory
summaryYesShort, one-line summary of the changes

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It fails to explain what 'interactive feedback' entails—whether it blocks, returns data, requires user input, or has side effects. This is insufficient for an agent to understand the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no extraneous information. While concise, it could benefit from additional structure or brevity, but it effectively communicates the core purpose without waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has a simple parameter set (2 strings) and no output schema, but the description omits critical context: what does 'interactive feedback' mean? Is feedback returned or is it a blocking interaction? The minimalism leaves an agent guessing about the tool's complete behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers 100% of parameters with descriptions. The tool description merely restates 'project directory and summary', adding no extra meaning. Schema coverage is high, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Request', the resource 'interactive feedback', and the context 'for a given project directory and summary'. It is specific and unambiguous, leaving no doubt about the tool's core function.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by stating 'Request interactive feedback' but provides no explicit guidance on when to use this tool or any alternatives. Since there are no sibling tools, differentiation is not needed, but the description lacks contextual cues for optimal use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedinteractive_feedback

TDQS

A3.9/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion between tools. The single tool 'interactive_feedback' serves a unique purpose.

Naming Consistency5/5

The single tool name follows a clear verb_noun pattern ('interactive_feedback'), and there are no other names to compare for inconsistency.

Tool Count5/5

The server is dedicated to interactive feedback, and one tool is perfectly scoped for this narrow purpose. Adding more tools would be unnecessary.

Completeness5/5

For the stated purpose of requesting interactive feedback on a project directory and summary, this single tool fully covers the expected functionality with no obvious gaps.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers