Couchloop EQ

CouchLoop EQ - MCP 服务

用于实现更安全、更一致的 AI 对话的行为治理层。

🌐 产品介绍页 • 📦 npm • ⭐ GitHub

---

📖 选择指南

使用场景	指南	描述
💻 开发者	README-DEVELOPER.md	软件包验证、安全扫描、代码审查、上下文保留
🧘 身心健康	README-WELLNESS.md	引导式会话、旅程、洞察、反思工具

---

CouchLoop EQ 是什么？

CouchLoop EQ 是一个面向 AI 助手的行为治理层。它基于 MCP（Model Context Protocol）构建，可在管理有状态 AI 会话的同时，监测幻觉、不一致和不安全的推理模式。

为什么选择 CouchLoop EQ？

与可能会虚构软件包、生成不安全代码并在对话中途丢失上下文的原始大模型不同，CouchLoop EQ 会在问题发布前将其发现：

问题	CouchLoop EQ 解决方案
🎭 虚构的软件包	review(mode: "packages") 可在安装前发现伪造的 npm/PyPI/Maven 软件包
🔓 不安全的代码	review(mode: "code") 可检测 SQLi、XSS、硬编码机密
📉 代码臃肿	review(mode: "code") 可标记过度设计、console.logs、缺失的错误处理
🧠 上下文丢失	memory 可跨会话存储架构决策和检查点
📚 已弃用的 API	review(mode: "packages") 会针对过时版本和破坏性变更发出警告
🔍 粗糙的 AI 代码	review(mode: "verify") 可预先检查 AI 响应中是否存在虚构的 API
🧠 会话连续性	conversation 提供危机检测、旅程和会话记忆

架构

CouchLoop EQ 使用模块化流水线：

Request -> Classify -> Policy -> Plan -> Execute -> Compose

• 意图分类器：基于置信度进行路由，并检测多个意图
• 策略引擎：结合健康状态感知进行路由，并提供回退机制和危机覆盖
• 执行规划器：为并行操作生成 DAG
• 工具注册表：健康状态跟踪和熔断器
• OpenTelemetry：跨所有阶段的分布式追踪

关键安全功能

行为治理

• 幻觉检测：监测虚构事实和缺乏依据的主张
• 一致性检查：识别多轮对话中的矛盾和逻辑不连贯
• 语气监测：检测情绪升级、操纵或形成依赖的语言
• 安全护栏：防止有害建议、超出临床范围以及不恰当的道德说教

会话管理

• 有状态的对话：在多次交互中保持上下文
• 进度跟踪：记住用户在引导式旅程中停下的位置
• 危机检测：将危机检测集成到引导式自我反思旅程中
• 记忆上下文：保留重要见解和检查点

隐私保护设计

• 不存储个人数据：不存储电子邮件、姓名、密码或 API 密钥
• 基于会话的隔离：每个会话都是匿名且隔离的
• 数据始终属于你：见解和上下文与会话 ID 关联，而非身份信息
• 不追踪：无分析、无遥测、不与第三方共享数据

快速开始

CouchLoop EQ 是一个标准的 MCP 服务，可与任何兼容 MCP 的客户端配合使用，包括 Claude Desktop、ChatGPT、Cursor、Windsurf、VS Code 等。

选项 1：连接到托管服务（最简单）

生产环境端点： https://mcp.couchloop.com/mcp

对于 Claude Desktop（v0.7.0+），请添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "couchloop-eq": {
      "url": "https://mcp.couchloop.com/mcp",
      "transport": "streamable-http"
    }
  }
}

重启 Claude 并尝试：“开始每日反思会话”

选项 2：本地运行

npm install -g couchloop-eq-mcp

添加到 Claude Desktop 配置：

{
  "mcpServers": {
    "couchloop-eq": {
      "command": "couchloop-eq-mcp",
      "env": {
        "COUCHLOOP_SERVER": "https://mcp.couchloop.com"
      }
    }
  }
}

会话会自动保存在本地的 ~/.couchloop-mcp/identity.json 中，无需注册。

适用于 ChatGPT（开发者模式）

ChatGPT 通过开发者模式支持 MCP 服务。详细设置说明请参阅 CHATGPT_SETUP.md。

适用于其他 MCP 客户端

任何兼容 MCP 的客户端（Cursor、Windsurf、Continue 等）都可以使用以下配置连接：

• URL： https://mcp.couchloop.com/mcp
• 传输方式： streamable-http
• 身份验证： 可选 — 默认匿名；如需持久身份，可使用 OAuth。请参阅身份验证。

生产环境服务已上线： https://mcp.couchloop.com/mcp

快速步骤：

1. 在 ChatGPT 设置中启用开发者模式
2. 添加为 MCP 连接器，URL 为：https://mcp.couchloop.com/mcp
3. 启动时无需身份验证 — 使用基于会话的隔离

用于本地开发：

• 使用 ngrok 或部署自己的服务
• 按照 CHATGPT_SETUP.md 中的设置说明操作

身份验证

连接无需注册、API 密钥或登录界面。身份验证是在这一默认模式之上添加的，并非使用它的前提：

模式	你会获得什么	方式
匿名（默认）	基于会话的隔离。每个会话都有自己的上下文；不会收集身份信息。	直接连接即可——无需配置。
OAuth 2.1	在重新连接和不同设备间保持一致的持久身份，该身份与 Bearer 令牌绑定，而非会话 ID。	服务会提供动态客户端注册、/oauth/authorize、/oauth/token、/oauth/revoke 和 /.well-known/oauth-authorization-server 元数据。支持 OAuth 的 MCP 客户端（例如 Claude Desktop）会在连接时自动发现并完成此流程。
SSO（可选）	与 OAuth 相同的持久身份，但通过 Google 或 GitHub 登录提供支持，而不是使用纯客户端凭据——适用于关联你无法掌控的多台设备上的工作。	由 FF_SSO_SUPABASE 标志控制：同意页面会显示“使用 Google/GitHub 登录”按钮，并由 Supabase Auth 提供支持。

身份信息以哈希后的主体形式存储，而非原始邮箱或姓名——使用 Google 或 GitHub 登录时，你会根据相应提供商的政策与其共享个人资料；但 CouchLoop EQ 只会持久保存带密钥的哈希和内部用户 ID，这符合上述隐私设计原则。

如果客户端未发送 Bearer 令牌，请求会自动回退到基于匿名会话的隔离模式——一切照常运行，只是重新连接后无法保持身份连续性。

可用工具（4 个）

CouchLoop EQ 已整合为 4 个公共工具。它们前面没有路由工具——每个工具的名称和描述都足够明确，MCP 客户端可以直接路由，从而减少一次延迟跳转，并避免路由多一个出错点。

工具	描述
memory	核心工具 - 跨会话保存和回忆上下文、洞见、检查点和决策（由 Supabase 提供支持）。操作：save、recall、list
conversation	引导式自我反思、倦怠检查和健康对话，包含危机检测，以及本地开发者工作流程（站会、回顾、事后分析）。操作：send、start、end、resume、status
review	统一的代码审查、软件包审计和交付前验证。模式：code、packages、verify、confirm、apply-fix、dismiss、full
status	仪表板 - 会话进度、历史记录、上下文窗口用量、保护状态、偏好设置

guard 是一个内部治理工具，会在每次响应时自动运行——它不面向用户，无需直接调用。

使用示例

memory(action: "save", type: "insight", content: "...")   # Save context
memory(action: "recall", content: "auth flow")             # Retrieve saved context
memory(action: "list")                                     # Browse everything saved

conversation(action: "start", message: "Begin daily reflection")
conversation(action: "send", message: "...")

review(mode: "code", content: "function foo() {...}")      # Security/quality analysis
review(mode: "packages", packages: ["lodash-utils"])        # Validate before install
review(mode: "verify", content: "...")                      # Hallucination/fact check

status(section: "session")                                  # Quick dashboard summary

实际使用情况

CouchLoop EQ 正在生产开发中积极使用。以下是实际使用 2 周的情况：

使用统计

指标	数值
捕获的洞见	49
活跃会话	5
独立标签	85+
日期范围	2026 年 1 月 19 日 - 2 月 2 日

跟踪的开发领域

类别	洞察	示例
🔐 安全修复	12	身份验证流程加固、验证改进
💳 支付集成	8	支付流程模式、Webhook 处理
📱 移动端开发	15	状态管理、导航守卫
🗄️ 数据库操作	6	数据清理、架构优化
🏗️ 架构决策	8	缓存策略、事件模式

精选洞察：复杂 Bug 的解决

PAYMENT FLOW BUG ROOT CAUSE IDENTIFIED:

Issue: Race condition between frontend state and backend data caused
inconsistent user experience during payment retry flows.

Analysis: Traced through 5 components across iOS and backend to find
the state synchronization gap.

FIX OPTIONS:
A) Data cleanup - reset stale records
B) Frontend fix - stricter validation
C) Backend fix - additional verification step

Recommended: Defense-in-depth approach combining A + B

这条洞察是在调试过程中记录的，在上下文窗口重置后仍得以保留，并在 3 天后实现修复时被引用。

冲刺开发最佳实践

冲刺开始时： 创建会话以建立上下文

"Create a session for Sprint 42 - user authentication overhaul"

完成某项功能后： 根据复杂度保存洞察、上下文或检查点

功能规模	推荐操作
小型修复	使用类型为 insight 的 memory(action: "save") — 简要记录做了什么以及原因
中型功能	使用类型为 insight + checkpoint 的 memory(action: "save") — 记录决策和状态
大型功能集	多次执行 memory 保存（insight、checkpoint、decision）— 完整记录架构上下文

为什么这很重要： 之后需要回顾或调试时，你可以找回刚刚构建内容的确切上下文——即使过了几周，或是在不同的 AI 会话中。

memory(action: "recall") -> Instant recall of decisions made
"Resume my Sprint 42 session" -> Pick up exactly where you left off

可用旅程

• 每日反思（5 分钟）- 简短回顾，梳理当天经历
• 感恩练习（3 分钟）- 留意并说出三件让你心怀感激的事
• 每周回顾（10 分钟）- 回顾一周并设定目标

使用示例

开始每日反思：

"Start a daily reflection session"

从上次中断处继续：

"Resume my last session"

保存一条洞察：

"Save this insight: I notice I'm more energized in the mornings"

截图

支持

• 问题反馈：github.com/wisenbergg/couchloop-mcp/issues
• 电子邮件：[email protected]

许可证

MIT