No description available
基于Node.js的现代化MCP反馈收集器,支持AI工作汇报和用户反馈收集。
npx mcp-feedback-collector
直接运行# 直接运行(推荐)
npx mcp-feedback-collector
# 或者全局安装
npm install -g mcp-feedback-collector
mcp-feedback-collector
创建 .env
文件:
# AI API配置
MCP_API_KEY="your_api_key_here"
MCP_API_BASE_URL="https://api.ssopen.top" # 中转站,也可使用OpenAI官方API
MCP_DEFAULT_MODEL="grok-3"
# Web服务器配置
MCP_WEB_PORT="5000"
MCP_DIALOG_TIMEOUT="60000" # 反馈收集超时时间(秒),范围:10-60000
# 功能开关
MCP_ENABLE_CHAT="true"
MCP_ENABLE_IMAGE_TO_TEXT="true" # 启用图片转文字功能
# URL和端口优化配置 (v2.0.7新增)
MCP_USE_FIXED_URL="true" # 使用固定URL,不带会话参数 (默认: true)
MCP_FORCE_PORT="false" # 强制使用指定端口 (默认: false)
MCP_KILL_PORT_PROCESS="false" # 自动终止占用进程 (默认: false)
MCP_CLEANUP_PORT_ON_START="true" # 启动时清理端口 (默认: true)
# 启动服务器(默认)
mcp-feedback-collector
# 指定端口
mcp-feedback-collector --port 8080
# 仅Web模式
mcp-feedback-collector --web
# 测试collect_feedback功能
mcp-feedback-collector test-feedback
# 自定义测试内容
mcp-feedback-collector test-feedback -m "我的工作汇报" -t 120
# 健康检查
mcp-feedback-collector health
# 显示配置
mcp-feedback-collector config
在Claude Desktop,cursor的MCP配置中添加:
{
"mcpServers": {
"mcp-feedback-collector": {
"command": "npx",
"args": ["-y", "mcp-feedback-collector@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",
"MCP_ENABLE_IMAGE_TO_TEXT": "true"
}
}
}
}
如果您克隆了源码并想直接运行,可以使用以下配置:
{
"mcpServers": {
"mcp-feedback-collector": {
"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"
}
}
}
}
注意:
path/to/your/project
替换为您的实际项目路径npm run build
构建项目d:/zhuomian/nodejsweb/dist/cli.js
如果您想直接运行TypeScript源码而无需构建:
{
"mcpServers": {
"mcp-feedback-collector": {
"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"
}
}
}
}
优点:无需构建,直接运行源码 缺点:启动稍慢,需要tsx依赖
假设您的项目位于 d:\zhuomian\nodejsweb
,推荐配置:
{
"mcpServers": {
"mcp-feedback-collector": {
"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"
}
}
}
}
配置步骤:
npm run build
your_api_key_here
为您的实际API密钥“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-feedback-collector.collect_feedback ”
⚠️ 重要提醒:
--debug
参数,这会导致JSON解析失败npx mcp-feedback-collector --debug
💡 API服务推荐:
https://api.ssopen.top
中转站,支持多种AI模型https://api.openai.com/v1
logging/setLevel
请求动态设置日志级别notifications/message
发送到MCP客户端http://localhost:5000
收集用户对AI工作的反馈:
// 基本调用(超时时间从环境变量读取)
collect_feedback("我已经完成了代码重构工作,主要改进了性能和可读性。")
本项目完全支持MCP协议标准的日志功能,提供专业级的日志管理:
服务器能力声明:
logging
能力支持的日志级别 (按优先级排序):
emergency
- 紧急情况,系统不可用alert
- 警报信息,需要立即处理critical
- 关键错误,严重问题error
- 错误信息,功能异常warning
- 警告信息,潜在问题notice
- 通知信息,重要事件info
- 一般信息,常规操作debug
- 调试信息,详细跟踪客户端控制:
{
"method": "logging/setLevel",
"params": {
"level": "info"
}
}
日志通知格式:
{
"method": "notifications/message",
"params": {
"level": "info",
"logger": "mcp-feedback-collector",
"data": {
"message": "服务器启动成功",
"port": 5000,
"url": "http://localhost:5000"
}
}
}
技术特性:
这使得Claude Desktop、Cursor等MCP客户端能够接收和处理服务器的日志信息,大大提升了开发和调试体验。
参数说明:
work_summary
(必需): AI工作汇报内容超时时间配置:
MCP_DIALOG_TIMEOUT
统一配置功能:
WebSocket连接失败
# 检查服务器状态
mcp-feedback-collector health
# 访问测试页面
http://localhost:5000/test.html
# 查看浏览器控制台错误信息
端口被占用
# 检查端口使用情况
netstat -an | grep :5000
# 使用其他端口
mcp-feedback-collector --port 5001
API密钥错误
# 检查配置
mcp-feedback-collector config
# 设置环境变量
export MCP_API_KEY="your_key_here"
权限问题
# 使用npx避免全局安装权限问题
npx mcp-feedback-collector
详细的故障排除指南请参考: TROUBLESHOOTING.md
本项目提供了完整的文档体系,请参考 📚 文档索引 查找您需要的信息:
# 克隆项目
git clone https://github.com/sanshao85/mcp-feedback-collector-web.git
cd mcp-feedback-collector-web
# 安装依赖
npm install
# 开发模式(实时编译TypeScript)
npm run dev
# 构建项目(生成dist目录)
npm run build
# 启动已构建的项目
npm start
# 测试
npm test
# 健康检查
npm start health
# 显示配置
npm start config
构建完成后,您可以使用以下配置在Cursor中测试:
{
"mcpServers": {
"mcp-feedback-collector": {
"command": "node",
"args": ["您的项目路径/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": "180"
}
}
}
}
src/
├── cli.ts # CLI入口
├── index.ts # 主入口
├── config/ # 配置管理
├── server/ # 服务器实现
├── utils/ # 工具函数
├── types/ # 类型定义
└── static/ # 静态文件
MIT License - 详见 LICENSE 文件
欢迎提交Issue和Pull Request!
git checkout -b feature/AmazingFeature
)git commit -m 'Add some AmazingFeature'
)git push origin feature/AmazingFeature
)https://api.ssopen.top/ API中转站,290+AI 大模型,官方成本七分之一,支持高并发!
{ "mcpServers": { "mcp-feedback-collector-web": { "command": "node", "args": [ "path/to/your/project/dist/cli.js" ] } } }
Related projects feature coming soon
Will recommend related projects based on sub-categories