mcp-interactive-feedback
Advanced tools
Nodejs based Interactive Feedback MCP Server - supports AI powered work reports and user feedback
Nodejs based Interactive Feedback MCP Server - supports AI powered work reports and user feedback.
npx mcp-interactive-feedback# Run directly (recommended)
npx mcp-interactive-feedback
# Or install globally
npm install -g mcp-interactive-feedback
mcp-interactive-feedback
Create a .env file:
# AI API Configuration
MCP_API_KEY="your_api_key_here"
MCP_API_BASE_URL="https://api.ssopen.top" # Proxy server, can also use OpenAI official API
MCP_DEFAULT_MODEL="grok-3"
# Web Server Configuration
MCP_WEB_PORT="5000"
MCP_DIALOG_TIMEOUT="60000" # Feedback collection timeout (seconds), range: 10-60000
# Feature Switches
MCP_ENABLE_CHAT="true"
# URL and Port Optimization Config (added in v2.0.7)
MCP_USE_FIXED_URL="true" # Use fixed URL without session parameters (default: true)
MCP_FORCE_PORT="false" # Force use of specified port (default: false)
MCP_KILL_PORT_PROCESS="false" # Automatically terminate occupying process (default: false)
MCP_CLEANUP_PORT_ON_START="true" # Clean up port on startup (default: true)
# Start server (default)
mcp-interactive-feedback
# Specify port
mcp-interactive-feedback --port 8080
# Only Web mode
mcp-interactive-feedback --web
# Test interactive-feedback functionality
mcp-interactive-feedback test-feedback
# Custom test content
mcp-interactive-feedback test-feedback -m "My work report" -t 120
# Health check
mcp-interactive-feedback health
# Display configuration
mcp-interactive-feedback config
In Claude Desktop, add the following to the cursor's MCP configuration:
{
"mcpServers": {
"mcp-interactive-feedback": {
"command": "npx",
"args": ["-y", "mcp-interactive-feedback@latest"],
"env": {
"MCP_API_KEY": "your_api_key_here",
"MCP_API_BASE_URL": "https://api.ssopen.top",
"MCP_DEFAULT_MODEL": "grok-3",
"MCP_WEB_PORT": "5050",
"MCP_DIALOG_TIMEOUT": "60000"
}
}
}
}
If you cloned the source code and want to run it directly, you can use the following configuration:
{
"mcpServers": {
"mcp-interactive-feedback": {
"command": "node",
"args": ["path/to/your/project/dist/cli.js"],
"env": {
"MCP_API_KEY": "your_api_key_here",
"MCP_API_BASE_URL": "https://api.ssopen.top",
"MCP_DEFAULT_MODEL": "grok-3",
"MCP_WEB_PORT": "5050",
"MCP_DIALOG_TIMEOUT": "60000"
}
}
}
}
Note:
path/to/your/project with your actual project pathnpm run build to build the projectd:/projects/nodejsweb/dist/cli.jsIf you want to run TypeScript source code directly without building:
{
"mcpServers": {
"mcp-interactive-feedback": {
"command": "npx",
"args": ["tsx", "path/to/your/project/src/cli.ts"],
"env": {
"MCP_API_KEY": "your_api_key_here",
"MCP_API_BASE_URL": "https://api.ssopen.top",
"MCP_DEFAULT_MODEL": "grok-3",
"MCP_WEB_PORT": "5050",
"MCP_DIALOG_TIMEOUT": "60000",
"NODE_ENV": "development"
}
}
}
}
Advantages: No need to build, directly run source code Disadvantages: Start a little slower, need tsx dependency
Assuming your project is located in d:\projects\nodejsweb, the recommended configuration:
{
"mcpServers": {
"mcp-interactive-feedback": {
"command": "node",
"args": ["d:/zhuomian/nodejsweb/dist/cli.js"],
"env": {
"MCP_API_KEY": "your_api_key_here",
"MCP_API_BASE_URL": "https://api.ssopen.top",
"MCP_DEFAULT_MODEL": "grok-3",
"MCP_WEB_PORT": "5050",
"MCP_DIALOG_TIMEOUT": "60000"
}
}
}
}
Configuration Steps:
npm run buildyour_api_key_here with your actual API key"Whenever you want to ask a question, always call the MCP .
Whenever you're about to complete a user request, call the MCP instead of simply ending the process. Keep calling MCP until the user's feedback is empty, then end the request. mcp-interactive-feedback.interactive-feedback
ā ļø Important Reminder:
--debug parameter in args, this will cause JSON parsing failurenpx mcp-interactive-feedback --debugš” API Service Recommendation:
https://api.ssopen.top proxy server, supports multiple AI modelshttps://api.openai.com/v1http://localhost:5000Collect user feedback on AI work:
// Basic call (timeout time read from environment variable)
interactive-feedback("I have completed the code refactoring work, mainly improving performance and readability.")
Parameter Description:
work_summary (Required): AI work report contentTimeout Time Configuration:
MCP_DIALOG_TIMEOUTFunction:
WebSocket Connection Failure
# Check server status
mcp-interactive-feedback health
# Access test page
http://localhost:5000/test.html
# View browser console error information
Port Occupied
# Check port usage
netstat -an | grep :5000
# Use other port
mcp-interactive-feedback --port 5001
API Key Error
# Check configuration
mcp-interactive-feedback config
# Set environment variable
export MCP_API_KEY="your_key_here"
Permission Problem
# Use npx to avoid global installation permission problem
npx mcp-interactive-feedback
Detailed fault troubleshooting guide please refer to: TROUBLESHOOTING.md
This project provides complete documentation system, please refer to š Documentation Index to find the information you need:
# Clone project
git clone https://github.com/TerrenceMiao/mcp-interactive-feedback.git
cd mcp-interactive-feedback-web
# Install dependencies
npm install
# Development Mode (Real-Time Compile TypeScript)
npm run dev
# Build Project (Generate dist Directory)
npm run build
# Start Built Project
npm start
# Test
npm test
# Health Check
npm start health
# Display Configuration
npm start config
After building, you can use the following configuration in cursor for testing:
{
"mcpServers": {
"mcp-interactive-feedback": {
"command": "node",
"args": ["Your Project Path/dist/cli.js"],
"env": {
"MCP_API_KEY": "your_api_key_here",
"MCP_API_BASE_URL": "https://api.ssopen.top",
"MCP_DEFAULT_MODEL": "grok-3",
"MCP_WEB_PORT": "5050",
"MCP_DIALOG_TIMEOUT": "60000"
}
}
}
}
src/
āāā cli.ts # CLI Entry
āāā index.ts # Main Entry
āāā config/ # Configuration Management
āāā server/ # Server Implementation
āāā utils/ # Tool Functions
āāā types/ # Type Definitions
āāā static/ # Static Files
MIT License - See LICENSE File
Welcome to submit Issue and Pull Request!
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)https://api.ssopen.top/ API Proxy Server, 290+ AI Large Models, Official Cost One-Seventh, Supports High Concurrency!
FAQs
Nodejs based Interactive Feedback MCP Server - supports AI powered work reports and user feedback
The npm package mcp-interactive-feedback receives a total of 5 weekly downloads. As such, mcp-interactive-feedback popularity was classified as not popular.
We found that mcp-interactive-feedback demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.Ā It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
npm now supports Trusted Publishing with OIDC, enabling secure package publishing directly from CI/CD workflows without relying on long-lived tokens.
Research
/Security News
A RubyGems malware campaign used 60 malicious packages posing as automation tools to steal credentials from social media and marketing tool users.
Security News
The CNA Scorecard ranks CVE issuers by data completeness, revealing major gaps in patch info and software identifiers across thousands of vulnerabilities.