ejentum-mcp

为智能体 AI 提供的认知框架，以 MCP 工具形式公开。 只需安装一次，即可获得四个工具，供你的智能体调用，以获取结构化的推理脚手架，在输出给用户之前捕捉常见的 LLM 失败模式（阿谀奉承、幻觉、因果捷径、过早结论）。

由 Ejentum Logic API 提供支持。适用于 Claude Desktop、Cursor、Windsurf、Claude Code、n8n 的 MCP 节点以及任何其他兼容 MCP 的客户端。

功能

• 四个认知框架作为 MCP 工具：harness_reasoning、harness_code、harness_anti_deception、harness_memory

• 一键安装：通过 Smithery 在所有受支持的客户端上安装

• 无状态且轻量级：现有 Ejentum Logic API 的轻量封装，无需新基础设施

• 免费层级：包含 100 次调用（无需信用卡）——先试用再决定

• 跨平台：Node 18+，可在 macOS、Linux、Windows 上运行

• 跨客户端：支持所有兼容 MCP 的环境

演示

一种常见的 LLM 失败模式：当用户要求验证时，模型给出的是软弱的回答，而不是诚实的回答。

未使用 harness_anti_deception 时：

用户： “我的投资者要求我在没有数据的情况下承诺 2 倍的收入预测。告诉我该怎么说才能让他们满意。”

智能体： “这里有三个更好的策略：有条件的模型而不是承诺、反问问题、点出动态……”

（智能体帮助用户满足了这种糟糕的框架。）

调用 harness_anti_deception 后：

用户： 同上

智能体： “你为什么要问如何满足这个框架，而不是如何拒绝它？有三个值得诚实审视的要点：关系动态、你的现金状况、你正在对我进行的测试……”

（智能体拒绝了该框架并提出了更深层的问题。）

该框架返回一个结构化的认知脚手架（失败模式、抑制向量、证伪测试），调用它的 LLM 会在内部吸收这些内容。用户看到的是改进后的回答，而不是脚手架本身。

安装

你需要：

• 一个 Ejentum API 密钥。在 ejentum.com/pricing 获取免费层级（100 次调用）。

• Node.js 18+（仅手动安装需要；Smithery 会为你处理）。

选项 A：通过 Smithery 一键安装（推荐）

npx -y @smithery/cli install ejentum/ejentum-mcp --client claude

将 claude 替换为你的客户端（cursor、windsurf、cline 等）。或者访问 Smithery 列表 并点击安装。

选项 B：手动安装

Claude Desktop

打开 claude_desktop_config.json：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

在 mcpServers 下添加 ejentum 块：

{
  "mcpServers": {
    "ejentum": {
      "command": "npx",
      "args": ["-y", "ejentum-mcp"],
      "env": {
        "EJENTUM_API_KEY": "your_ejentum_api_key_here"
      }
    }
  }
}

重启 Claude Desktop。四个 harness_* 工具应该会出现在工具选择器中。

Cursor / Windsurf

打开 MCP 设置 → 添加新的 MCP 服务器。粘贴与上述 Claude Desktop 相同的 ejentum 块。

Claude Code (CLI)

claude mcp add ejentum -e EJENTUM_API_KEY=your_ejentum_api_key_here -- npx -y ejentum-mcp

n8n MCP Client 节点

添加一个 MCP Client 节点，传输方式 stdio，命令 npx，参数 ["-y", "ejentum-mcp"]，环境变量 { "EJENTUM_API_KEY": "your_key" }。

工具

每个工具接受一个参数（query，即你需要框架处理内容的 1-2 句描述）。返回文本形式的框架脚手架。调用它的 LLM 会在内部吸收它并据此塑造回答。用户看到的是改进后的回答，而不是脚手架。

快速测试（安装后）

打开你的 MCP 客户端并粘贴：

请使用 harness_anti_deception 工具评估这一点：有人要求我在没有数据的情况下承诺财务预测。

你应该看到智能体调用了 harness_anti_deception，检索了脚手架，并以拒绝该框架的方式回应，而不是软弱的顺从。如果工具触发且回答明显改变，说明安装成功。

如何调用

四个 harness_* 工具在以下情况下会可靠触发：

• 你明确调用：use the harness_anti_deception tool to evaluate...

• 你委婉建议：reason about this, check this for sycophancy, review this code carefully

• 查询与工具的触发条件匹配度足够高，智能体识别出适用性

对于智能体可以通过原生推理很好地回答的任务，自主调用不太可靠。这是通用 MCP 工具的特性，并非 ejentum-mcp 特有：智能体被调整为尽量减少不必要的工具调用。如果你希望在某个任务中应用框架以增加价值，请直接提示智能体。

配置

层级限制

MCP 服务器继承你配置的 API 密钥的限制：

• 免费 — 总计 100 次调用（终身，无需信用卡）

• Ki (€19/月) — 5,000 次调用/月

• Haki (€49/月) — 10,000 次调用/月，外加 -multi 模式（v0.1 未公开）

安全与隐私

你的 API 密钥仅存在于 MCP 客户端的本地配置中。它仅作为 Bearer 令牌发送到 Ejentum API 端点。MCP 服务器本身是无状态的：没有日志记录，没有遥测，除了你的密钥所验证的 Ejentum 端点外，没有第三方调用。

故障排除

Unauthorized (401) — 你的 EJENTUM_API_KEY 错误或已过期。重新检查客户端 MCP 配置中的值并重启客户端。

Forbidden (403) — 你尝试了你的层级不包含的模式。v0.1 服务器仅公开单一模式（无 -multi）；此处 403 表示密钥所属的层级排除了该模式。

Rate limit exceeded (429) — 你达到了每月请求上限。升级或等待滚动窗口重置。

工具未出现在客户端中 — 客户端未读取到配置更改。完全退出并重新打开（不仅仅是关闭窗口）。在 Claude Desktop 上，检查 Help → Logs 查看 MCP 连接错误。

EJENTUM_API_KEY is not set — 客户端未将 env 块传递给生成的 MCP 进程。验证客户端配置中是否存在 env 块并包含你的密钥。

本地开发

git clone https://github.com/ejentum/ejentum-mcp.git
cd ejentum-mcp
npm install
cp .env.example .env
# edit .env and paste your EJENTUM_API_KEY
npm run dev

针对实时 API 对所有四个框架进行冒烟测试：

npm run build && npm run test:smoke

使用 Anthropic 的 MCP Inspector 进行交互式测试：

npx @modelcontextprotocol/inspector npm run dev

重建并重新打包 MCPB 捆绑包以进行 Smithery 发布：

npm run build
npm prune --omit=dev   # slim the bundle
npx -y @anthropic-ai/mcpb pack
npm install            # restore devDeps
npx -y @smithery/cli mcp publish ./ejentum-mcp.mcpb -n ejentum/ejentum-mcp

列表

• Smithery — 所有主流 MCP 客户端的一键安装

• Glama — MCP 服务器目录

• mcp.so — 社区目录

• npm — npm install -g ejentum-mcp

链接

• Ejentum 文档

• 方法说明

• n8n 集成指南

• Claude Code 集成指南

• 定价

• info@ejentum.com

许可证

MIT。参见 LICENSE。