情绪检测MCP服务器

Name: 情绪检测MCP服务器
Author: PV-Bhat

作者：PV-Bhat322 星标更新：2025-11-20

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Vibe Check MCP

<p align="center"><b>再见过度热情的代理。即插即用的代理监督工具。</b></p> <p align="center"> <b>基于研究：</b><br/> 在我们的研究中，调用 Vibe Check 的代理提高了成功 +27%，并将有害行为减少了 -41%。 </p> <p align="center"> <a href="https://www.researchgate.net/publication/394946231_Do_AI_Agents_Need_Mentors_Evaluating_Chain-Pattern_Interrupt_CPI_for_Oversight_and_Reliability?channel=doi&linkId=68ad6178ca495d76982ff192&showFulltext=true"> <img src="https://img.shields.io/badge/Research-CPI%20%28MURST%29-blue?style=flat-square" alt="CPI 研究"> </a> <a href="https://github.com/modelcontextprotocol/servers"><img src="https://img.shields.io/badge/Anthropic%20MCP-featured-111?labelColor=111&color=555&style=flat-square" alt="Anthropic MCP：列出"></a> <a href="https://registry.modelcontextprotocol.io/"><img src="https://img.shields.io/badge/MCP%20Registry-listed-555?labelColor=111&style=flat-square" alt="MCP 注册表"></a> <a href="https://www.pulsemcp.com/servers/pv-bhat-vibe-check"> <img src="https://img.shields.io/badge/PulseMCP-Most%20Popular%20(Oct%202025)-0b7285?style=flat-square" alt="PulseMCP：最流行（本周）"> </a> <a href="https://github.com/PV-Bhat/vibe-check-mcp-server/actions/workflows/ci.yml"><img src="https://github.com/PV-Bhat/vibe-check-mcp-server/actions/workflows/ci.yml/badge.svg" alt="CI 通过"></a> <a href="https://smithery.ai/server/@PV-Bhat/vibe-check-mcp-server"><img src="https://smithery.ai/badge/@PV-Bhat/vibe-check-mcp-server" alt="Smithery 徽章"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0b7285?style=flat-square" alt="MIT 许可证"></a> </p> <p align="center"> <sub>在 PulseMCP 上被评为“本周最流行” • 每月在 Smithery.ai 上有超过 5k 次调用 • 基于研究的监督 • STDIO + 可流式传输的 HTTP 运输</sub> </p> <img width="500" height="300" alt="Gemini_Generated_Image_kvdvp4kvdvp4kvdv" src="https://gips3.baidu.com/it/u=2552365390,1344055327&fm=3081&app=3081&f=PNG?w=1248&h=610" />

即插即用的导师层，阻止代理过度工程化，并保持它们在最小可行路径上——基于研究的 MCP 服务器，使 LLM 保持一致、反思和安全。

<div align="center"> <a href="https://github.com/PV-Bhat/vibe-check-mcp-server"> <img src="https://unpkg.com/@lobehub/icons-static-svg@latest/icons/github.svg" width="40" height="40" alt="GitHub" /> </a>    <a href="https://registry.modelcontextprotocol.io"> <img src="https://unpkg.com/@lobehub/icons-static-svg@latest/icons/anthropic.svg" width="40" height="40" alt="Anthropic MCP 注册表" /> </a>    <a href="https://smithery.ai/server/@PV-Bhat/vibe-check-mcp-server"> <img src="https://unpkg.com/@lobehub/icons-static-svg@latest/icons/smithery.svg" width="40" height="40" alt="Smithery" /> </a>    <a href="https://www.pulsemcp.com/servers/pv-bhat-vibe-check"> <img src="https://www.pulsemcp.com/favicon.ico" width="40" height="40" alt="PulseMCP" /> </a> </div> <div align="center"> <em>被 MCP 平台和注册表上的开发者所信赖</em> </div>

快速开始 (npx)

无需本地安装即可直接从 npm 运行服务器。需要 Node >=20。选择一种传输方式：

选项 1 – 通过 STDIO 的 MCP 客户端

npx -y @pv-bhat/vibe-check-mcp start --stdio

从一个了解 MCP 的客户端启动（如 Claude Desktop, Cursor, Windsurf 等）。
[MCP] stdio 传输连接 表示进程正在等待客户端。
将此块添加到您的客户端配置中，以便它生成命令：

{
  "mcpServers": {
    "vibe-check-mcp": {
      "command": "npx",
      "args": ["-y", "@pv-bhat/vibe-check-mcp", "start", "--stdio"]
    }
  }
}

选项 2 – 手动 HTTP 检查

npx -y @pv-bhat/vibe-check-mcp start --http --port 2091

使用 curl http://127.0.0.1:2091/health 确认服务已运行。
向 http://127.0.0.1:2091/rpc 发送 JSON-RPC 请求。

npx 根据需求下载包，适用于以上两种选项。有关详细客户端设置和其他命令如 install 和 doctor，请参阅以下文档。

认可

被 PulseMCP “本周最流行”首页推荐（2025年10月13日那一周）🔗
列入 Anthropic 官方模型上下文协议仓库 🔗
在官方 MCP 注册表中可发现 🔗
被 Sean Kochel 推荐为适合 vibe 编码者的前 9 名 MCP 服务器之一 🔗

快速开始 (npx)
什么是 Vibe Check MCP？
概述
问题：模式惯性与推理锁定
关键特性
[v2.7.4 新增内容](#v2.7.4 新增内容)
开发环境设置
发布
使用示例
自适应元认知中断 (CPI)
代理提示基础
何时使用每个工具
文档
研究与哲学
安全性
路线图
贡献者与社区
常见问题解答
在哪里可以找到 Vibe Check MCP
致谢与许可证

什么是 Vibe Check MCP？

Vibe Check MCP 保持代理在最小可行路径上，并仅在证据要求时增加复杂度。Vibe Check MCP 是一个轻量级服务器，实现了 Anthropic 的模型上下文协议。它充当您代理的 AI 元导师，通过 链模式中断 (CPI) 来打断模式惯性，防止推理锁定 (RLI)。将其视为 LLM 的橡胶鸭调试器——在代理走错路之前进行快速检查。

概述

Vibe Check MCP 结合了元认知信号层和 CPI，使得代理可以在风险上升时暂停。Vibe Check 显示特征、不确定性和风险分数；CPI 消费这些触发器并在代理恢复之前执行干预策略。请参阅 CPI 集成指南和 CPI 仓库 https://github.com/PV-Bhat/cpi 获取接线细节。

Vibe Check 调用第二个 LLM 给主代理提供元认知反馈。将 vibe_check 调用集成到代理系统提示中，并在不可逆操作前指示工具调用，显著提高代理的一致性和常识。高层次组件图：docs/architecture.md，而 CPI 交接图和示例适配器则记录在 docs/integrations/cpi.md 中。

问题：模式惯性与推理锁定

大型语言模型可能会自信地遵循错误的计划。没有外部提示，它们可能会陷入过度工程或偏离目标。Vibe Check 通过短暂的反思暂停提供了这种提示，提高了可靠性和安全性。

关键特性

特性	描述	优点
CPI 自适应中断	阶段感知提示挑战假设	一致性、健壮性
多提供商 LLM	支持 Gemini、OpenAI、Anthropic 和 OpenRouter	灵活性
历史连续性	当提供 `sessionId` 时总结先前建议	上下文保留
可选 vibe_learn	记录错误和修复以供未来反思	自我改进

v2.7.4 新增内容

install --client 现在支持 Cursor、Windsurf 和 Visual Studio Code，具有幂等合并、原子写入和 .bak 回滚功能。
HTTP 意识安装程序保留 Windsurf 的 serverUrl 条目，并在未提供配置时发出 VS Code 工作区片段以及 vscode:mcp/install 链接。
文档现在整合了提供商密钥、运输选择、卸载指导以及专门的客户端文档，位于 docs/clients.md。

会话构成（每会话规则）

使用轻量级“宪法”来强制执行每个 sessionId 的规则，CPI 将遵守这些规则。例如，宪法规则：“禁止外部网络调用”，“优先在重构前编写单元测试”，“永不将秘密写入磁盘”。

API（工具）：

update_constitution({ sessionId, rules }) → 合并/设置会话规则集
reset_constitution({ sessionId }) → 清理会话规则
check_constitution({ sessionId }) → 返回会话的有效规则

开发环境设置

# 克隆并安装
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server
npm ci
npm run build
npm test

使用 npm 进行所有工作流程（npm ci、npm run build、npm test）。该项目针对 Node >=20。

创建一个 .env 文件，包含您打算使用的 API 密钥：

# Gemini（默认）
GEMINI_API_KEY=your_gemini_api_key
# 可选提供商 / Anthropic 兼容端点
OPENAI_API_KEY=your_openai_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
ANTHROPIC_AUTH_TOKEN=your_proxy_bearer_token
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_VERSION=2023-06-01
# 可选覆盖
# DEFAULT_LLM_PROVIDER 接受 gemini | openai | openrouter | anthropic
DEFAULT_LLM_PROVIDER=gemini
DEFAULT_MODEL=gemini-2.5-pro

配置

请参阅 docs/TESTING.md 以获取如何运行测试的说明。

Docker

该存储库包括一个辅助脚本，用于一键设置。

bash scripts/docker-setup.sh

请参阅自动 Docker 设置以获取完整详情。

提供商密钥

请参阅 API 密钥及密钥管理以获取支持的提供商、解析顺序、存储位置及安全指南。

运输选择

CLI 支持 stdio 和 HTTP 运输。运输解析遵循以下顺序：显式标志（--stdio/--http）→ MCP_TRANSPORT → 默认 stdio。当使用 HTTP 时，请指定 --port（或设置 MCP_HTTP_PORT）；默认端口是 2091。生成的条目相应地添加 --stdio 或 --http --port <n>，并且 HTTP 能力客户端还收到一个 http://127.0.0.1:<port> 端点。

客户端安装程序

每个安装程序都是幂等的，并且条目带有 "managedBy": "vibe-check-mcp-cli" 标签。每次运行前都会写入备份，更改应用后合并是原子的（*.bak 文件使回滚变得容易）。请参阅 docs/clients.md 以获取更深入的客户端特定参考。

Claude Desktop

配置路径：claude_desktop_config.json（根据平台自动发现）。
默认传输：stdio（npx … start --stdio）。
安装后重启 Claude Desktop 以加载新的 MCP 服务器。
如果已经存在未管理的 vibe-check-mcp 条目，CLI 不会修改它并打印警告。

Cursor

配置路径：~/.cursor/mcp.json（如果存储在其他地方，请提供 --config）。
架构镜像 Claude 的 mcpServers 布局。
如果文件丢失，CLI 打印一个可以粘贴到 Cursor 设置面板中的 JSON 块，而不是失败。

Windsurf (Cascade)

配置路径：旧版 ~/.codeium/windsurf/mcp_config.json，新构建使用 ~/.codeium/mcp_config.json。
传递 --http 以发出带有 serverUrl 的条目，供 Windsurf 的 HTTP 客户端使用。
现有的哨兵管理 serverUrl 条目会被保存并就地更新。

Visual Studio Code

工作区配置位于 .vscode/mcp.json；个人资料也将在您的 VS Code 用户数据目录中存储 mcp.json。
提供 --config <path> 以指向工作区文件。如果没有 --config，CLI 打印一个 JSON 片段和一个可以从终端打开的 vscode:mcp/install?... 链接。
VS Code 支持可选的开发字段；传递 --dev-watch 和/或 --dev-debug <value> 以填充 dev.watch/dev.debug。

卸载与回滚

恢复安装期间生成的备份（配置旁边的最新 *.bak），立即回滚。
若要手动删除服务器，请删除 mcpServers 下的 vibe-check-mcp 条目（Claude/Windsurf/Cursor）或 servers（VS Code），只要它仍然带有 "managedBy": "vibe-check-mcp-cli" 标签。

研究与哲学

CPI（链模式中断） 是 Vibe Check 背后的基于研究的监督方法。它在风险转折点注入短暂而恰到好处的“暂停点”，重新对齐代理与用户的真正优先事项，防止破坏性级联和 推理锁定 (RLI)。在 153 次运行的综合评估中，CPI 几乎将成功率翻倍（约 27%→54%），并将有害行为减少了一半（约 83%→42%）。最佳中断剂量约为步骤的 10–20%。*Vibe Check MCP 在测试时