基本能力
产品定位
Vibe Coder MCP Server 是一个专为AI助手设计的模型上下文协议服务器，旨在通过强大的软件开发工具增强AI助手的能力。它支持研究、规划、需求生成、创建启动项目等多种功能，适用于软件开发的全生命周期。
核心功能
- 语义请求路由：基于嵌入的语义匹配和顺序思考回退机制智能路由请求。
- 工具注册架构：集中管理自注册工具。
- 直接LLM调用：生成工具使用直接LLM调用，提高可靠性和结构化输出控制。
- 工作流执行：运行预定义的工具调用序列。
- 代码生成与重构：生成代码存根和改进现有代码片段。
- 依赖分析：从清单文件中列出项目依赖。
- Git集成：总结当前Git变更。
- 研究与规划：进行深度研究并生成规划文档（如PRD、用户故事、任务列表等）。
- 项目脚手架：生成全栈启动套件。
- 异步执行：长时间运行的工具异步执行，返回Job ID，最终结果通过
get-job-result工具获取。 - 会话状态管理：在会话中跨请求维护基本状态（内存中）。
- 标准化错误处理：所有工具一致的错误模式。
适用场景
- 软件开发中的代码生成与重构
- 项目规划和需求文档生成
- 技术研究和依赖分析
- Git变更管理和总结
- 全栈项目脚手架生成
工具列表
- 代码生成与重构工具：
generate-code-stub,refactor-code - 分析与信息工具：
analyze-dependencies,git-summary,research-manager - 规划与文档工具：
generate-rules,generate-prd,generate-user-stories,generate-task-list - 项目脚手架工具：
generate-fullstack-starter-kit - 工作流与编排工具：
run-workflow
常见问题解答
- 连接问题：检查配置路径和格式，确保JSON有效且路径正确。
- API密钥问题：确保OpenRouter密钥正确且在.env文件中配置。
- 路径和权限问题：确保用户有写入权限，检查构建目录是否存在。
- 日志调试：设置
LOG_LEVEL=debug以获取详细日志。
使用教程
使用依赖
- 检查Node.js版本：运行
node -v确保版本为v18.0.0或更高。 - 检查Git安装：运行
git --version确保Git已安装。 - 获取OpenRouter API密钥：访问openrouter.ai创建并复制API密钥。
安装教程
- 克隆仓库：
bash
git clone https://github.com/freshtechbro/vibe-coder-mcp.git
cd vibe-coder-mcp - 运行安装脚本：
- Windows：运行
setup.bat - macOS/Linux：运行
chmod +x setup.sh后运行./setup.sh - 配置环境变量：编辑
.env文件，添加OpenRouter API密钥。
调试方式
- 启动服务器：运行
npm start（生产模式）或npm run dev（开发模式）。 - 测试工具：通过AI助手发送命令如
Research modern JavaScript frameworks测试功能。 - 检查日志：设置
LOG_LEVEL=debug以获取详细日志信息。
