Feedback Server

An interactive feedback system for MCP (Model Context Protocol) that allows agents to request user feedback during task execution.

Overview

This system consists of:

• feedback_server.py: The main MCP server that runs in your terminal and handles feedback requests
• feedback_client.py: A test client script demonstrating how agents connect to request feedback

Installation

1. Install the required dependencies:

pip install mcp

Usage

Step 1: Start the Feedback Server

Run the server in a terminal:

python feedback_server.py

The server will:

• Start on localhost:9876
• Display a message when ready
• Show agent requests and allow you to provide feedback interactively

Step 2: Configure Your MCP Agent

Add the server to your MCP configuration file (e.g., mcp_config.json):

{
  "mcpServers": {
    "feedback-server": {
      "command": "python",
      "args": [
        "/<path_to_script>/feedback_client.py"
      ]
    }
  }
}

Step 3: Agent Prompt

Use this prompt with your agent:

Whenever you're about to complete a user request, call the MCP interactive_feedback instead of simply ending the process. Keep calling MCP until the user's feedback is empty, then end the request.

How It Works

1. Agent calls the tool: When an agent needs feedback, it calls the interactive_feedback tool with:

   • work_summary: Summary of work completed so far
   • question (optional): Specific question for the user

2. Server displays request: The feedback server shows:

   • Timestamp of the request
   • Work summary from the agent
   • Any specific questions

3. User provides feedback: In the terminal running the server:

   • Type feedback and press Enter to send it back to the agent
   • Press Enter with empty input to approve and let the agent continue

4. Agent receives response: The agent gets either:

   • User feedback to act upon
   • Approval to continue (when feedback is empty)

Example Interaction

In the server terminal:

🚀 Feedback Server started on localhost:9876
Waiting for agent connections...

==============================================================
📝 AGENT REQUEST - 2025-01-15 14:30:45
==============================================================

Work Summary:
I have completed the following tasks:
1. Created the user authentication system
2. Set up the database models
3. Implemented the API endpoints

Agent's Question:
Should I proceed with adding the frontend components?

==============================================================
📌 Your Feedback (press Enter with empty input to approve and continue):
> Yes, but make sure to use React with TypeScript
✅ Feedback sent to agent: 'Yes, but make sure to use React with TypeScript'

Features

• ✅ Real-time interactive feedback
• ✅ Socket-based communication (no polling)
• ✅ Clear visual feedback in terminal
• ✅ Support for both general feedback and specific questions
• ✅ Simple approval mechanism (empty input = continue)
• ✅ Error handling and connection management

Troubleshooting

• Connection refused: Make sure the feedback server is running before the agent tries to connect
• Port already in use: The server uses port 9876 by default. Make sure no other process is using this port
• MCP not found: Install the MCP package using pip install mcp

Architecture

The system uses a dual-server architecture:

1. MCP Server: Handles the MCP protocol and tool definitions
2. Socket Server: Manages the interactive feedback loop in the terminal

This design allows for real-time interaction while maintaining compatibility with the MCP protocol.