戈斯纳普·麦克普
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 });许可证
麻省理工学院