使用说明

项目简介

Vibe Check MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 AI 助手提供元认知监督。它通过集成 'vibe_check'、'vibe_distill' 和 'vibe_learn' 三个核心工具，帮助 AI 助手在工作流程中进行自我反思和调整，避免陷入思维定势、过度设计以及偏离用户意图等问题，从而提升 AI 助手的效率和输出质量。

主要功能点

元认知检查 (vibe_check): 在 AI 助手进行任务规划、代码实现或结果审查等阶段，通过提出针对性的问题，促使 AI 助手反思当前思路，打破可能存在的思维局限，确保方案的合理性和有效性。
计划精简 (vibe_distill): 当 AI 助手提出的解决方案或计划变得过于复杂和繁琐时，'vibe_distill' 工具可以帮助其提炼出核心步骤和关键要素，避免不必要的复杂化，实现更简洁高效的方案。
模式学习 (vibe_learn): 通过记录 AI 助手在工作过程中出现的错误和相应的纠正措施，'vibe_learn' 工具构建了一个持续学习和改进的反馈循环，帮助 AI 助手识别和避免重复犯错，长期提升其问题解决能力。

安装步骤

克隆仓库: 在您的本地计算机上，使用 Git 克隆 Vibe Check MCP Server 仓库：

git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git

进入项目目录: 使用 'cd' 命令进入克隆下来的仓库目录：
```
cd vibe-check-mcp-server
```
安装依赖: 运行 'npm install' 命令安装项目所需的 Node.js 依赖包：
```
npm install
```
构建项目: 运行 'npm run build' 命令编译 TypeScript 代码，生成可执行的 JavaScript 文件：
```
npm run build
```

服务器配置

为了让 MCP 客户端（例如 Claude）能够连接到 Vibe Check MCP Server，您需要在客户端的配置文件中添加服务器的启动信息。以下是一个 'claude_desktop_config.json' 文件的配置示例：

{
  "vibe-check": {
    "serverName": "vibe-check",  // 服务器名称，用于在客户端中标识和调用
    "command": "node",        // 启动服务器的命令，这里使用 Node.js 运行 JavaScript 文件
    "args": [
      "/path/to/vibe-check-mcp-server/build/index.js" // 服务器入口文件 build/index.js 的绝对路径，请替换为您的实际路径
    ],
    "env": {
      "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"  // (可选) Gemini API 密钥，用于更高级的元认知检查，如果您希望使用该功能，请配置您的 API 密钥
    }
  }
}

请务必注意: 将 '/path/to/vibe-check-mcp-server' 替换为 Vibe Check MCP Server 在您本地文件系统中的实际路径。'GEMINI_API_KEY' 是可选的环境变量，仅当您需要使用 Gemini API 驱动的更高级元认知功能时才需要配置。

基本使用方法

启动服务器: 在 Vibe Check MCP Server 仓库目录下，运行以下命令启动服务器：
```
npm run start
```
服务器成功启动后，您应该能在终端看到 "Vibe Check MCP server running" 的提示信息。
配置 MCP 客户端: 根据您的 MCP 客户端（如 Claude）的文档，配置服务器连接信息，将上面提供的 JSON 配置添加到客户端的配置文件中。
在 AI 助手工作流程中调用工具: 在您的 AI 助手的工作流程中，当需要进行元认知检查、计划精简或模式学习时，调用相应的工具（'vibe_check'、'vibe_distill' 或 'vibe_learn'），并根据工具的输入参数要求，提供必要的上下文信息，例如用户请求、当前计划、思维日志等。工具的调用方式和参数格式请参考仓库中的 'src/index.ts' 和 'src/tools/' 目录下的代码。

关键词