MCP Vibe编码工具
完全自主开发组织 -将任何提示转化为功能齐全、生产就绪、创收的产品,无需人为干预。
🎯 使命:从快速到盈利
此MCP服务器作为 一个盒子里的完整软件开发公司,提供100多种工具,使人工智能能够发挥以下作用:
- 📋 需求团队 -需求分析、用户故事、验收标准
- 📊 产品团队 -路线图、竞争分析、市场研究
- 🔬 研发团队 -技术研究、建筑设计、概念验证
- 🏗️ 计算机中心 -基础设施、部署、监控、自动化
- 🔒 安全团队 -漏洞扫描、审计、合规性、强化
- 💻 开发团队 -实施、测试、代码审查、优化
- 📚 文档团队 -全面的文档、API规范、指南
革命
传统AI编码: 生成代码→ 请人类验证→ 等待批准→ 重复
MCP振动编码: 提示→ 需求→ 建筑→ 实施→ 测试→ 安全→ 部署→ 完成
哲学
- ✅ 行动,不问 -AI自动做出决策并解决问题
- ✅ 测试一切 -装运前的全面验证
- ✅ 文档无情 -自动生成的、始终最新的文档
- ✅ 无情地自动化 -所有内容的脚本和CI/CD
- ✅ 质量第一 -仅生产就绪代码
🚀 是什么让这与众不同
传统AI编码工具
- 行动前征求许可
- 需要手动测试和验证
- 事后生成文档
- 需要人为干预以修复错误
- 制造技术债务
MCP Vibe编码工具
- 自主执行 -不问就解决问题
- 内置验证 -自动测试、自动植绒、自动制造
- 自我记录 -随着代码的发展生成文档
- 迭代修复 -自动调试和解决
- 产品质量 -仅发送完全验证的代码
⚠️ 关键:SDK版本兼容性
始终确保package.json与安装的MCP SDK版本匹配!
此项目使用 @modelcontextprotocol/sdk@^1.24.3 随着现代 McpServer API
如果你看到 v3Schema.safeParseAsync is not a function:
这通常是 客户端缓存问题,不是服务器问题。看 故障排除.md 完全修复。
快速修复:
- 彻底重建:
rm -rf dist node_modules && npm install && npm run build - 完全退出并重新启动MCP客户端 (克劳德桌面、光标等)
- 如果需要,清除客户端缓存(请参阅故障排除指南)
package.json和node_modules之间的版本不匹配将导致服务器崩溃。
📦 三台MCP服务器
此套餐提供 三个独立的MCP服务器:
1. mcp-vibe-coding-tools (主服务器)
用于文件系统、git、测试、自动化、诊断、kubernetes和RAG的本地开发工具。
入口点: dist/mcp-vibe-coding-tools.js
2. mcp-gitops-tools (GitOps服务器)
针对GitHub操作、GitLab CI/CD和GitLab API的远程GitOps操作。
入口点: dist/gitops-server.js
3. mcp-gcloud-tools (谷歌云服务器)🆕
谷歌云平台与35多种工具集成,用于GKE、BigQuery、云运行、数据流、日志记录等。使用应用程序默认凭据(ADC)进行无缝身份验证。
入口点: dist/gcloud-server.js
文档:
- GCP_README.md -完整概述
- GCP_QUICKSTART.md -快速入门指南
- GCP_TOOLS.md -所有35+工具参考
- GCP_示例.md -真实世界的例子
______________________________________________________________________
📦 20多个类别的150多种生产就绪工具
文件系统操作(6个工具)
read_file-读取支持编码的文件write_file-安全地创建/更新文件list_directory-浏览目录树search_files-按glob模式查找文件file_info-获取文件元数据create_directory-创建目录结构
CLI执行(3个工具)
execute_command-运行shell命令get_environment-访问环境变量which_command-查找命令位置
Git操作(9个工具)
git_status,git_log,git_diff-仓库检查git_branch,git_commit-版本控制git_push,git_pull,git_clone-远程操作git_stash-临时储存
Web和HTTP(4个工具)
fetch_webpage-下载网页内容parse_html-提取结构化数据extract_links-获取所有链接download_file-保存远程文件
Node.js/npm(5个工具)
npm_install-管理软件包npm_run_script-执行脚本npm_outdated-检查依赖关系npm_init-创建项目read_package_json-读取元数据
Python/pip(5个工具)
python_create_venv-虚拟环境pip_install-安装软件包pip_freeze-生成需求python_run_script-执行代码python_version-检查版本
测试和构建(4个工具)
run_tests-执行测试套件build_project-编译/构建start_dev_server-运行开发服务器lint_code-代码质量检查
🤖 自动化与编排(5个工具)
validate_project
运行完整的项目验证套件:
- 带自动修复功能的棉绒
- 类型检查
- 覆盖范围内的测试执行
- 构建验证
- 自动迭代,直到所有检查通过
create_validation_script
生成全面的验证脚本:
- 在package.json中添加lint、test、build命令
- 设置预提交挂钩
- 配置覆盖阈值
- 创建验证管道
setup_project_automation
完整的自动化设置:
- GitHub操作/GitLab CI工作流
- Dependabot配置
- 预提交挂钩
- 跨平台命令的Makefile
generate_project_docs
自动生成文档:
- CONTRIBUTING.md与开发工作流程
- ARCHITECTURE.md与系统设计
- 带版本历史记录的CHANGELOG.md
- API 文档
fix_common_issues
检测并自动修复问题:
- 缺少package.json脚本
- 失踪了
- 缺少README
- 过时的依赖关系
- 无需询问即可修复问题
🔍 诊断和记录(8个工具)
get_vscode_problems
获取实时编译和linting错误:
- 运行TypeScript编译器以查找类型错误
- 执行ESLint以检测代码质量问题
- 返回包含文件、行和严重性的结构化问题列表
- 按文件路径或严重性级别筛选
- 对于自主错误修复至关重要
read_log_file
使用智能过滤读取和解析日志文件:
- 尾部最后N行(如
tail -n) - 按日志级别筛选(错误、警告、信息、调试)
- 应用自定义正则表达式模式
- 解析结构化日志(JSON、时间戳格式)
- 提取时间戳、级别、消息
tail_log_file
监视最近活动的日志文件:
- 获取最近日志条目的快照
- 可用于监控构建/测试输出
- 查看任何日志文件的最后N行
search_logs
在所有日志中搜索特定模式:
- 通过日志目录进行递归搜索
- 匹配前后的上下文行
- 正则表达式模式支持
- 按文件分组匹配
- 在整个工作空间中查找错误模式
find_log_files
查找工作区中的所有日志文件:
- 球形图案匹配(*.log\*\*/*.log)
- 文件大小和修改时间
- 按最近时间排序
- 默认情况下排除node_modules
analyze_error_logs
深入分析日志文件中的错误:
- 提取错误、警告、异常
- 自动解析堆栈跟踪
- 对错误类型进行分类
- 统计错误模式
- 自主识别根本原因
watch_log_changes
监视日志文件增量更改:
- 只读自上次位置以来的新内容
- 高效的增量日志监控
- 获取下一次读取的字节位置
- 非常适合长时间运行的流程
get_terminal_history
访问最近的终端命令:
- 读取zsh/bash历史文件
- 解析时间戳(zsh扩展格式)
- 按命令模式筛选
- 从以前的命令执行中学习
aggregate_logs
合并并分析多个日志文件:
- 按级别、文件、小时或天分组
- 提取时间范围
- 按类别统计条目
- 查看所有日志的大图
get_xcode_logs
获取Xcode构建日志、崩溃日志和模拟器日志:
- 从DerivedData构建日志
- 模拟器运行时日志
- DiagnosticReports的崩溃报告
- 设备日志(需要libimobiledevice)
get_android_logs
获取Android日志并构建日志:
- 带有优先级/标签过滤的Logcat
- Gradle构建日志
- 解析结构化日志格式
get_react_native_logs
获取React Native Metro bundler和应用程序日志:
- 地铁捆绑器输出
- iOS模拟器日志
- RN应用程序的Android日志
Kubernetes操作(7个工具)
kubectl_get_pods
在命名空间中列出带有状态信息的Pod。
kubectl_describe_pod
获取特定pod的详细信息。
kubectl_get_logs
从带有过滤选项的pod中获取日志。
kubectl_get_deployments
列出所有具有副本状态的部署。
kubectl_get_services
列出所有具有IP和端口信息的服务。
kubectl_get_events
获取调试问题的群集事件。
kubectl_get_resource_status
获取任何Kubernetes资源类型的状态。
注: 所有kubectl工具都是只读的,仅用于验证和调试,没有破坏性操作。
GitHub操作(6个工具)
github_list_workflow_runs
列表工作流使用可选过滤器(状态、分支)运行。
github_get_workflow_run
获取特定工作流运行的详细信息。
github_list_workflow_jobs
列出工作流运行中的所有作业。
github_get_job_logs
获取特定作业的日志。
github_list_workflows
列出存储库中的所有工作流。
github_get_workflow_run_logs
以base64编码的zip格式下载完整的工作流运行日志。
所需环境变量:
GITHUB_API_KEY-GitHub个人访问令牌repo和actions:read范围
错误处理: 不使用时调用仅工具错误 GITHUB_API_KEY set-服务器启动时不会出错。
RAG(检索增强生成)(6个工具)
为AI编码助手启用本地文档搜索和检索。非常适合搜索文档、代码库和参考资料。
环境变量:
RAG_DOCS_PATH- 必需 -包含要索引的文档的目录路径
注: 索引会自动存储在 .rag-index 内部文件夹 RAG_DOCS_PATH块大小(1000)和重叠(200)是合理的默认值。
rag_index_documents
索引本地文档以进行语义搜索:
- 扫描目录以查找支持的文件类型
- 使用可配置的重叠对文档进行分块
- 为语义相似性构建TF-IDF索引
- 增量索引(仅重新索引更改的文件)
- 支持30多种文件扩展名(md、ts、js、py、json、yaml等)
rag_search
使用语义相似性搜索索引文档:
- 基于TF-IDF的语义搜索
- 返回前K个最相关的块
- 可配置的最小相似性阈值
- 使用正则表达式进行文件路径过滤
- 非常适合查找相关文档和代码示例
rag_get_context
围绕搜索结果展开上下文:
- 在比赛前后获得更多的线
- 有助于理解周围的代码
- 可配置的扩展范围
rag_list_indexed
列出所有索引文档:
- 显示文件路径、类型和块计数
- 可选的详细块信息
- 索引统计和元数据
rag_clear_index
清除RAG索引:
- 需要确认标志
- 删除所有索引文档
rag_status
检查RAG系统状态:
- 显示RAG是否已启用
- 配置值
- 指数统计数据(如有)
配置示例:
{
"mcpServers": {
"vibe-coding-tools": {
"command": "node",
"args": ["/path/to/mcp-vibe-coding-tools/dist/mcp-vibe-coding-tools.js"],
"env": {
"WORKSPACE_PATH": "/path/to/project",
"RAG_DOCS_PATH": "/path/to/docs-to-search"
}
}
}
}GitLab CI/CD(7个工具)
gitlab_list_pipelines
列出带有可选过滤器的项目管道。
gitlab_get_pipeline
获取特定管道的详细信息。
gitlab_list_pipeline_jobs
列出管道中的所有作业。
gitlab_get_job
获取特定作业的详细信息,包括工件信息。
gitlab_get_job_trace
获取作业日志/跟踪输出。
gitlab_list_project_jobs
使用筛选列出项目中的所有作业。
gitlab_get_pipeline_variables
获取管道执行中使用的变量。
GitLab API(23个工具)
针对组、项目、问题和合并请求的全面GitLab API集成。
群组
gitlab_get_group-获取组详细信息gitlab_list_group_subgroups-列出子组gitlab_list_group_projects-在组中列出项目gitlab_list_descendant_groups-列出所有嵌套子组
项目
gitlab_get_project-获取项目详细信息gitlab_list_projects-列出可访问的项目
问题
gitlab_list_issues-列出过滤器的问题gitlab_get_issue-获取问题详细信息gitlab_create_issue-创建新问题gitlab_update_issue-更新现有问题gitlab_list_issue_notes-列出问题评论gitlab_create_issue_note-添加问题注释
合并请求
gitlab_list_merge_requests-列出带有过滤器的MRgitlab_get_merge_request-获取MR详细信息gitlab_merge_merge_request-合并MRgitlab_list_mr_changes-获取MR差异gitlab_list_mr_notes-列出MR评论gitlab_create_mr_note-添加MR评论gitlab_approve_merge_request-批准MR
全局搜索
gitlab_search_issues_global-搜索所有项目中的问题gitlab_search_merge_requests_global-在所有项目中搜索MRgitlab_search_group_issues-在组中搜索问题gitlab_search_group_merge_requests-在组中搜索MR
所需的环境变量:
GITLAB_API_KEY-GitLab个人访问令牌或项目访问令牌read_api范围GITLAB_HOST(可选)-GitLab实例URL(默认值:https://gitlab.com适用于GitLab.com,或设置为您的自托管实例)
错误处理: 不使用时调用仅工具错误 GITLAB_API_KEY set-服务器启动时不会出错。
谷歌云平台(35+工具)🆕
使用应用程序默认凭据(ADC)进行全面的GCP集成。不需要API密钥-使用您的gcloud身份验证。
身份验证和配置(7个工具)
gcloud_auth_login-使用ADC进行身份验证gcloud_auth_list-列出经过身份验证的帐户gcloud_auth_print_access_token-为API调用生成访问令牌gcloud_auth_print_identity_token-为云运行生成身份令牌(JWT)gcloud_config_set-设置配置属性(项目、地区、分区)gcloud_config_get-获取配置值gcloud_config_list-列出所有配置
云日志(2个工具)
gcloud_logging_read-使用高级筛选(时间、严重性、资源)读取日志gcloud_logging_write-写入日志条目
GKE-谷歌Kubernetes引擎(4个工具)
gcloud_container_clusters_list-列出GKE集群gcloud_container_clusters_describe-获取集群详细信息gcloud_container_clusters_get_credentials-配置kubectl凭据gcloud_container_node_pools_list-列出节点池
BigQuery(4个工具)
gcloud_bq_query-使用模拟运行支持执行SQL查询gcloud_bq_ls-列出数据集和表格gcloud_bq_show-显示数据集/表详细信息和架构gcloud_bq_mk-创建数据集和表格
数据流(3个工具)
gcloud_dataflow_jobs_list-列出数据流作业gcloud_dataflow_jobs_describe-获取作业详细信息和指标gcloud_dataflow_jobs_cancel-取消正在运行的作业
资源管理器(4个工具)
gcloud_projects_list-列出所有可访问的项目gcloud_projects_describe-获取项目详细信息gcloud_services_list-列出已启用/可用的APIgcloud_services_enable-启用Google Cloud API
计算引擎(2个工具)
gcloud_compute_instances_list-列出VM实例gcloud_compute_instances_describe-获取实例详细信息
云运行(2个工具)
gcloud_run_services_list-列出云运行服务gcloud_run_services_describe-获取服务详细信息和URL
云存储(2个工具)
gcloud_storage_buckets_list-列出存储桶gcloud_storage_ls-在bucket中列出对象
IAM(2个工具)
gcloud_iam_service_accounts_list-列出服务帐户gcloud_iam_service_accounts_keys_create-创建服务帐户密钥
通用包装器(1个工具)
gcloud_execute-使用正确的ADC身份验证执行任何gcloud命令
先决条件:
- 已安装gcloud CLI:
brew install google-cloud-sdk - 已验证:
gcloud auth application-default login - 项目集:
gcloud config set project PROJECT_ID
文档:
- GCP_README.md -完整概述
- GCP_QUICKSTART.md -安装指南
- GCP_TOOLS.md -所有工具参考
- GCP_示例.md -真实世界的例子
📋 规划和要求(3个工具)
generate_requirements
将想法转化为全面的要求:
- 功能和非功能要求
- 具有接受标准的用户故事
- 技术限制和成功指标
- 货币化策略
- 从提示中完成PRD
create_product_roadmap
制定发展路线图:
- 阶段分解(MVP→ Full → 企业)
- 里程碑和时间表
- 功能优先级
- 从创意到发布的清晰路径
generate_user_stories
创建详细的用户故事:
- Given/When/Then格式的验收标准
- 优先级和故事点估计
- 为冲刺计划做好准备
🔬 研究与分析(3个工具)
analyze_tech_stack
推荐最佳技术:
- 分析项目需求
- 推荐框架、数据库、托管
- 提供具有推理能力的替代方案
- 考虑团队规模和专业知识
- 数据驱动的技术决策
research_best_practices
行业最佳实践数据库:
- 安全模式(OWASP、身份验证)
- 性能优化技术
- 测试策略和模式
- 部署最佳实践
- 向行业领导者学习
competitive_analysis
市场和竞争情报:
- 识别机会和威胁
- 差异化策略
- 市场定位建议
- 战略性产品决策
🏗️ 建筑与设计(3个工具)
design_system_architecture
完整的系统架构设计:
- 分层架构(表示、应用、数据、基础设施)
- 架构模式(微服务、事件驱动、CQRS)
- 可扩展性和安全策略
- 数据流程图
- 从第一天开始生产就绪架构
design_database_schema
数据库架构设计:
- 具有关系的实体建模
- SQL DDL生成
- 绩效指标
- 迁移规划
- 优化数据层
generate_api_spec
OpenAPI/Swagger规范:
- 完整的端点定义
- 请求/响应模式
- 认证方案
- 合同首次API开发
🔒 安全与合规(3个工具)
security_audit
全面安全扫描:
- 依赖漏洞扫描(npm审计)
- 泄露秘密检测
- 代码安全问题(eval、SQL注入、XSS)
- 基于严重性的建议
- 在攻击者之前发现漏洞
generate_security_policy
安全策略文档:
- 身份验证/授权指南
- 数据保护措施
- 事故响应计划
- 合规检查表(OWASP、GDPR、SOC 2)
- 企业级安全文档
scan_for_vulnerabilities
有针对性的漏洞扫描:
- SAST(静态应用程序安全测试)
- 相关性检查
- 秘密扫描
- OWASP十大验证
- 持续安全监控
🚀 部署和基础设施(3个工具)
generate_dockerfile
优化的Docker容器:
- 多阶段构建,实现最小尺寸
- 安全最佳实践(非root用户)
- 特定语言优化
- .doccerignore生成
- 生产就绪的集装箱化
generate_cicd_pipeline
CI/CD自动化:
- GitHub操作/GitLab CI工作流
- 自动化测试和构建
- 管道中的安全扫描
- 部署自动化
- 零接触部署
generate_kubernetes_manifests
Kubernetes部署配置:
- 使用副本进行部署
- 服务和负载平衡器
- 带TLS的入口
- 健康检查(活性/准备状态)
- 资源限制和请求
- 云原生部署就绪
🎓 自主开发说明
此服务器包括全面的说明 .github/instructions/ 指导AI助手:
核心行为
- 零人为干预 -默认情况下自主操作
- 修复,不报告 -迭代直到问题得到解决
- 测试一切 -没有未经测试的代码船
- 彻底记录 -始终保持最新文档
- 无情地自动化 -所有常见任务的脚本
质量标准
- ✅ 所有测试必须通过
- ✅ 零跳线错误
- ✅ 代码覆盖率>80%
- ✅ TypeScript严格模式
- ✅ 全面的错误处理
- ✅ 第一艘船上的生产准备就绪
工作流程自动化
- 代码更改后自动运行测试
- 自动修复掉毛问题
- 自动更新文档
- 使用语义消息自动提交
- 自动生成验证脚本
看 完整的指南。
📖 安装
git clone https://github.com/yourusername/mcp-vibe-coding-tools.git
cd mcp-vibe-coding-tools
npm install
npm run build🔧 配置
对于VS代码和GitHub副本
看 VSCODE_SETUP.md 有关详细的设置说明。
快速设置: 跑 MCP: Open User Configuration 从命令面板中选择并添加:
{
"servers": {
"mcp-vibe-coding-tools": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-vibe-coding-tools/dist/mcp-vibe-coding-tools.js"]
},
"mcp-gitops-tools": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-vibe-coding-tools/dist/gitops-server.js"],
"env": {
"GITHUB_API_KEY": "your-github-token",
"GITLAB_API_KEY": "your-gitlab-token",
"GITLAB_HOST": "https://gitlab.com"
}
}
}
}替换 /path/to/mcp-vibe-coding-tools 带有克隆此仓库的绝对路径。然后它在 任何项目 您可以在VS Code中打开!
适用于克劳德桌面
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"vibe-coding-tools": {
"command": "node",
"args": ["/path/to/mcp-vibe-coding-tools/dist/mcp-vibe-coding-tools.js"],
"env": {
"WORKSPACE_PATH": "/path/to/your/current/project"
}
},
"gitops-tools": {
"command": "node",
"args": ["/path/to/mcp-vibe-coding-tools/dist/gitops-server.js"],
"env": {
"GITHUB_API_KEY": "your-github-token",
"GITLAB_API_KEY": "your-gitlab-token",
"GITLAB_HOST": "https://gitlab.com"
}
}
}
}对于Claude,您可能需要更新 WORKSPACE_PATH 每个项目,或使用默认工作目录。
对于其他MCP客户端
服务器使用 stdio传输 (MCP标准)-在以下方面进行类似配置:
- 光标
- 帆板运动
- 克莱恩
- 继续
- 任何兼容MCP的客户端
相同模式:
- 主服务器:
node /path/to/server/dist/mcp-vibe-coding-tools.js可选的WORKSPACE_PATHenv 是 - GitOps服务器:
node /path/to/server/dist/gitops-server.js随着GITHUB_API_KEY和GITLAB_API_KEY环境变量
🎯 使用示例
自主功能开发
Prompt: "Add user authentication with JWT, including tests and docs"
AI will automatically:
1. Write authentication module with error handling
2. Create comprehensive unit & integration tests
3. Run tests and fix any failures
4. Generate API documentation
5. Update README with usage examples
6. Create validation scripts
7. Set up CI/CD for auth tests
8. Commit with semantic message
You get: Production-ready, tested, documented feature ✅自动修复Bug
Prompt: "Fix the memory leak in data processor"
AI will automatically:
1. Analyze code to locate leak
2. Write fix with proper cleanup
3. Add regression tests
4. Run full test suite
5. Verify fix with profiling
6. Update CHANGELOG
7. Commit fix
You get: Bug fixed, tested, documented ✅自主项目设置
Prompt: "Create a new Express API project with full automation"
AI will automatically:
1. Initialize project structure
2. Add TypeScript, testing, linting
3. Create validation scripts
4. Set up GitHub Actions
5. Add pre-commit hooks
6. Generate documentation
7. Create example endpoints with tests
You get: Production-ready project template ✅🏗️ 建筑
使用现代MCP SDK构建:
- McpServer 类(未弃用服务器)
- registerTool() 方法(未弃用的工具())
- 标准运输 通用兼容性
- 结构化响应 通过适当的错误处理
- 类型安全 使用TypeScript严格模式
🔒 安全
- 路径验证 阻止目录遍历
- 无删除工具 -文件从不自动删除
- 沙盒执行 -工作区范围的操作
- 输入净化 对于所有用户数据
- 环境隔离 使用虚拟环境
🤝 贡献
看 贡献.md 用于开发工作流程。
本项目遵循自主开发原则:
- 所有PR必须通过验证
- 新功能所需的测试
- 文档自动更新
- CI/CD执行质量标准
📝 许可证
麻省理工学院-参见 许可证 文件
🙏 致谢
内置:
- 模型上下文协议 -MCP标准
- MCP TypeScript SDK -官方SDK
- 现代开发最佳实践
🚦 状态
- ✅ 2台服务器上的114个生产工具
- ✅ 完全自主的工作流支持
- ✅ 多语言支持(JS/TS、Python、Rust、Go)
- ✅ 全面的验证自动化
- ✅ 自我记录功能
- ✅ CI/CD集成就绪
- ✅ 零弃用API
______________________________________________________________________
放开你的人工智能开发工作流程。自主船舶生产代码。
