MCP Feedback Enhanced Community Fix

来源与致谢

• 原始项目：noopstudios/interactive-feedback-mcp
• 官方增强版：Minidoracat/mcp-feedback-enhanced
• 官方增强版作者：Minidoracat
• 参考修复版：Huo-zai-feng-lang-li/fix-MCP-Feedback-Enhanced
• 参考修复版维护者：Huo-zai-feng-lang-li

这个仓库基于上面的项目链路继续整理和维护，主要目标是保留原有使用方式，同时修复我自己实际使用过程中遇到的几个关键问题。

这是我基于 Minidoracat/mcp-feedback-enhanced 整理出来的个人维护修复版。

官方增强版已经长期没有继续处理一些实际可用性问题，而我本地又一直在用，所以把自己修过、验证过的一些 bug 收敛成了这个 GitHub 仓库，方便同样被这些问题卡住的人直接拿去用。

这个仓库当前只提供 GitHub 源码使用方式，不发布 npm 包，也不额外改命令名。目标很直接：保持原有接入方式基本不变，优先解决可用性问题。

这个仓库修了什么

1. 修复图片附件返回的序列化兼容问题

上游部分实现仍依赖 FastMCP Image 类型，某些环境下会导致图片附件返回报错或序列化失败。

这个仓库把图片返回统一切到标准 mcp.types.ImageContent，尽量减少不同 MCP 运行时组合下的兼容性问题。

2. 修复 Dashboard / Web 面板打不开的问题

随着 Starlette / FastAPI 相关依赖更新，TemplateResponse 的调用顺序已经变化。旧写法会导致面板打开时报 500，页面直接起不来。

这个仓库已经兼容新的 TemplateResponse(request, name, context) 调用方式。

3. 默认超时时间改为一周

我把默认等待时间从 600 秒调整为 604800 秒，也就是一周。

这个改动参考并吸收了 fix-MCP-Feedback-Enhanced 的思路，适合需要长时间挂着等待下一轮反馈的场景。

和上游的差异

相对 Minidoracat/mcp-feedback-enhanced，这个仓库目前重点维护的是下面这些实际问题：

• 默认超时时间从 600 秒调整为 604800 秒
• 图片附件返回改为 ImageContent，降低附件序列化报错概率
• 修复 Starlette 兼容问题，避免面板页面 500

如果你只是想继续使用原有功能，但正好被上面这几个问题卡住，这个仓库更适合直接拿来本地跑。

适合谁

• 你已经在用 mcp-feedback-enhanced
• 你不想重新适配一套新的 MCP
• 你遇到了面板打不开、图片传不上去、等待时间太短这些问题
• 你接受通过本地源码方式接入 Cursor

使用方式

1. 克隆仓库

git clone https://github.com/orime/mcp-feedback-enhanced-community-fix.git
cd mcp-feedback-enhanced-community-fix

2. 安装依赖

uv sync

3. 在 Cursor 里配置 MCP

把下面配置加入 Cursor 的 MCP 配置中，把路径改成你自己的本地目录：

{
  "mcpServers": {
    "mcp-feedback-enhanced": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp-feedback-enhanced-community-fix",
        "mcp-feedback-enhanced"
      ],
      "timeout": 600000,
      "env": {
        "MCP_DESKTOP_MODE": "false",
        "MCP_WEB_PORT": "8765",
        "MCP_LANGUAGE": "zh-CN",
        "MCP_DEBUG": "false"
      },
      "autoApprove": [
        "interactive_feedback"
      ]
    }
  }
}

如果你更习惯显式跑模块，也可以改成：

{
  "mcpServers": {
    "mcp-feedback-enhanced": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp-feedback-enhanced-community-fix",
        "python",
        "-m",
        "mcp_feedback_enhanced"
      ],
      "timeout": 600000,
      "env": {
        "MCP_DESKTOP_MODE": "false",
        "MCP_WEB_PORT": "8765",
        "MCP_LANGUAGE": "zh-CN",
        "MCP_DEBUG": "false"
      },
      "autoApprove": [
        "interactive_feedback"
      ]
    }
  }
}

常用环境变量

变量	说明	默认值
MCP_DESKTOP_MODE	是否启用桌面模式	false
MCP_WEB_HOST	Web UI 监听地址	127.0.0.1
MCP_WEB_PORT	Web UI 端口	8765
MCP_LANGUAGE	界面语言	自动检测
MCP_DEBUG	是否输出调试日志	false

本地测试

uv run mcp-feedback-enhanced version
uv run mcp-feedback-enhanced test --web

说明

• 这个仓库当前优先解决我自己实际遇到的问题，不承诺跟上游保持完全同步
• 如果上游后续恢复维护并合入这些修复，我也建议优先回到上游
• 如果你只是需要一个能稳定跑的本地版本，这个仓库就是为这个目的准备的

致谢

感谢下面这些项目和作者：

• noopstudios/interactive-feedback-mcp
• Minidoracat/mcp-feedback-enhanced
• Huo-zai-feng-lang-li/fix-MCP-Feedback-Enhanced

本仓库基于上游工作继续修补和整理，不是从零重写。

License

沿用上游仓库许可证，见 LICENSE。