AI导哈

UI反馈处理协议服务器

gosnap-mcp是一个用于处理UI反馈的协议服务器，通过HTTP API接收UI注释/反馈，并通过MCP工具将其暴露给AI代理（如Claude Code、Cursor、Copilot等）。

  • by bienhoang
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 bienhoang/pro-ui-feedbacks-mcp

使用说明

戈斯纳普·麦克普

MCP（模型上下文协议）服务器，用于AI代理进行UI反馈处理。

通过HTTP API接收UI注释/反馈，并通过MCP工具将其暴露给AI代理（Claude Code、Cursor、Copilot、Windsurf、Codex等）。

快速开始

npx gosnap-mcp

这从两个方面开始：

  • MCP服务器 在stdio上（用于AI代理通信）
  • HTTP API 上 http://127.0.0.1:4747 （用于接收反馈）

安装

npm install -g gosnap-mcp

代理配置

所有兼容MCP的代理都使用类似的JSON配置：

{
  "mcpServers": {
    "gosnap": {
      "command": "npx",
      "args": ["gosnap-mcp"]
    }
  }
}

自动设置

npx gosnap-mcp init

检测已安装的代理并自动写入配置。

配置位置

代理 配置文件
克劳德代码 ~/.claude/mcp.json
光标 .cursor/mcp.json
VS代码/副本 .vscode/mcp.json
风帆冲浪 .codeium/windsurf/mcp_config.json

MCP工具

工具 说明
list_sessions 列出所有活动反馈会话
get_pending_feedback 获取未解决的反馈（可选按会话）
acknowledge_feedback 标记已看到的反馈
resolve_feedback 用摘要标记为已解决
dismiss_feedback 理智地拒绝

HTTP API

方法 端点 描述
POST /api/feedback 提交新反馈
POST /api/webhook 小部件同步（SyncPayload）
GET /api/sessions 列出所有会话
GET /api/sessions/:id 获取包含反馈的会话
GET /api/health 健康检查

提交反馈

curl -X POST http://127.0.0.1:4747/api/feedback \
  -H 'Content-Type: application/json' \
  -d '{
    "comment": "Fix the button color",
    "pageUrl": "https://example.com/page",
    "intent": "fix",
    "severity": "important"
  }'

CLI命令

命令 描述
npx gosnap-mcp 启动服务器（默认）
npx gosnap-mcp server 启动服务器
npx gosnap-mcp server --port 8080 自定义HTTP端口
npx gosnap-mcp server --mcp-only 仅支持MCP，不支持HTTP
npx gosnap-mcp init 自动配置代理
npx gosnap-mcp doctor 验证设置

程序化使用

import { startServer } from 'gosnap-mcp';

await startServer({ port: 4747, mcpOnly: false });

许可证

麻省理工学院

相关 MCP