# MCP Feedback Enhanced Community Fix

## 来源与致谢

- 原始项目：[noopstudios/interactive-feedback-mcp](https://github.com/noopstudios/interactive-feedback-mcp)
- 官方增强版：[Minidoracat/mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced)
- 官方增强版作者：[Minidoracat](https://github.com/Minidoracat)
- 参考修复版：[Huo-zai-feng-lang-li/fix-MCP-Feedback-Enhanced](https://github.com/Huo-zai-feng-lang-li/fix-MCP-Feedback-Enhanced)
- 参考修复版维护者：[Huo-zai-feng-lang-li](https://github.com/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. 克隆仓库

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

### 2. 安装依赖

```bash
uv sync
```

### 3. 在 Cursor 里配置 MCP

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

```json
{
  "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"
      ]
    }
  }
}
```

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

```json
{
  "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` |

## 本地测试

```bash
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](LICENSE)。