Ejentum Mcp

io.github.ejentum由 GitHub 帳號 ejentum 發布v0.2.2更新於 Oct 25, 2026

Reasoning, code, anti-deception, memory harness MCP tools. Stdio or HTTPS api.ejentum.com/mcp

已驗證Streamable HTTP可網頁執行知識與記憶AI 與機器學習

概覽

AI 產生的概覽

Ejentum MCP 為助理提供結構化的推理流程與 DAG 拓撲,讓它在回答複雜多步任務前先套用。

可以做什麼
取得推理支架:針對任務查詢回傳編號步驟、DAG 拓撲、失敗模式與否證測試,支援推理、程式碼、反欺騙、記憶四種模式,以及以任務專屬識別字改寫步驟的自適應版本(需 Go 或 Super 方案)。檢視框架:列出六個認知失敗維度及其主要失敗模式。探索認知協同圖:組合含根節點、前置、放大與回退算子的多跳認知 DAG。檢索能力庫:對推理能力執行 SQLite FTS5 全文關鍵字搜尋並依 BM25 排序。
適用情境
適合助理處理複雜、多步驟或多限制任務,且存在幻覺、因果倒置、樂觀偏誤或誤差累積風險時,在回答前注入結構化流程。也適合檢視失敗分類與能力庫。
執行需求
需要 Ejentum API 金鑰(EJENTUM_API_KEY,以 Authorization Bearer 權杖傳送),提供 30 天免費試用;自適應工具需 Go 或 Super 方案。本機安裝需 Node.js 18+,透過 npx 或 npm 執行;亦提供託管的 Streamable HTTP 端點。需能存取 Ejentum API。
安裝前請注意
API 金鑰是機密,透過環境變數或 Authorization 標頭傳遞。請求會計入金鑰用於計費,查詢文字會送至 Ejentum API 供檢索。自適應模式增加延遲且需付費方案;各方案有速率限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ejentum Mcp,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.ejentum%2Fejentum-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "ejentum": {
      "type": "http",
      "url": "https://api.ejentum.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

ejentum-mcp

[npm version] [License: MIT] [Node] [MCP Registry] [Glama score] [Last commit]

MCP server that improves LLM reasoning on complex, multi-step, or multi-constraint tasks. Before the agent generates, it calls one of eight tools to retrieve a cognitive operation: a structured procedure (numbered steps with the failure pattern to refuse and a falsification test) paired with an executable reasoning topology (a DAG of those steps with decision gates, parallel branches, bounded loops, meta-cognitive exits, and escape paths). The agent reads both layers before producing its response.

Eight tools split into two retrieval modes:

  • Dynamic (4 tools: reasoning, code, anti-deception, memory): the top-1 abstract operation from a library of 679, selected by semantic match on the query string. Available on all tiers including the 30-day free trial.
  • Adaptive (4 tools: adaptive-reasoning, adaptive-code, adaptive-anti-deception, adaptive-memory): the same retrieval pool, but an adapter LLM rewrites every step and DAG node in the matched operation with task-specific identifiers (e.g., extract_duration_estimates becomes extract_migration_duration_estimates(DDL_time|backfill_time|trigger_overhead|lock_hold_time)). Adds ~2-3 s of latency; requires the Go or Super tier.

Two install paths use the same EJENTUM_API_KEY:

  1. Stdio via npx -y ejentum-mcp for Claude Desktop, Cursor, Windsurf, Codex CLI, Claude Code, Cline, Continue, and any client that spawns MCP servers as subprocesses.
  2. Hosted Streamable HTTP at https://api.ejentum.com/mcp for n8n MCP Client and any HTTP-MCP client. Send Authorization: Bearer YOUR_EJENTUM_API_KEY.

Install

You need:

Install from npm

bash
npm install ejentum-mcp

Or skip the install and reference it with npx -y ejentum-mcp directly in your client config (shown below).

Manual install

Claude Desktop

Open claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "ejentum": {      "command": "npx",      "args": ["-y", "ejentum-mcp"],      "env": { "EJENTUM_API_KEY": "ej_..." }    }  }}

Restart Claude Desktop. The eight tools appear in the tool picker.

Cursor / Windsurf

Open MCP settings → Add new MCP server → paste the same ejentum block as above.

Claude Code (CLI)
bash
claude mcp add ejentum -e EJENTUM_API_KEY=ej_... -- npx -y ejentum-mcp
n8n MCP Client node

Add an MCP Client node, transport stdio, command npx, args ["-y", "ejentum-mcp"], env { "EJENTUM_API_KEY": "ej_..." }.


Wire contract

The stdio MCP server and the hosted endpoint both proxy to the same upstream:

POST https://api.ejentum.com/harness/Headers:  Authorization: Bearer <EJENTUM_API_KEY>  Content-Type: application/jsonBody:  {    "query": "<string, 1-2 sentences describing the task>",    "mode":  "reasoning" | "code" | "anti-deception" | "memory"           | "adaptive-reasoning" | "adaptive-code"           | "adaptive-anti-deception" | "adaptive-memory"  }Response (200):  [ { "<mode>": "<injection string, ~2-4 KB>" } ]Response (401): { "error": "Unauthorized; check EJENTUM_API_KEY" }Response (403): { "error": "Adaptive modes require Go or Super tier" }Response (429): { "error": "Rate limit exceeded for tier" }

The response is an array of length 1 with a single key matching the request mode. Use bracket access (result[0]["anti-deception"]) for the hyphenated keys; dot access parses the hyphen as subtraction in JavaScript and Python attribute access.

The injection string is plain text containing seven fields. See Field structure below.


Tool inventory

Dynamic (single retrieval, all tiers including the 30-day trial)

Tool nameMode stringLibrary size
reasoningreasoning311 operations across abstraction, time, causality, simulation, spatial, metacognition
codecode128 operations across the software-engineering layer
anti-deceptionanti-deception139 operations across sycophancy, hallucination, deception, adversarial framing, judgment, executive control
memorymemory101 operations in the perception layer (filter-oriented; do not call for fact extraction)

Adaptive (top-k retrieval + adapter LLM rewrite; Go or Super tier required)

Tool nameMode stringBehavior vs dynamic
adaptive-reasoningadaptive-reasoningSame retrieval pool, top-5 then picker, then adapter LLM rewrites PROCEDURE and REASONING TOPOLOGY fields with task-specific identifiers. Adds ~2-3 s of latency.
adaptive-codeadaptive-codeSame as above for the code library.
adaptive-anti-deceptionadaptive-anti-deceptionSame as above for the anti-deception library.
adaptive-memoryadaptive-memorySame as above for the memory library.

Each tool takes one argument, query (string, 1-2 sentences describing the task). Returns the injection string.


Field structure of an injection

Every retrieved record contains seven labelled blocks plus a cognitive payload. The exact set of labels varies by mode:

The fields appear in this fixed order in every response. Each mode uses its own label for the same slot (e.g., [PROCEDURE] in reasoning corresponds to [ENGINEERING PROCEDURE] in code):

OrderSlotPer-mode labelsContent
1Procedure[PROCEDURE] (reasoning) · [ENGINEERING PROCEDURE] (code) · [INTEGRITY PROCEDURE] (anti-deception) · [SHARPENING PROCEDURE] (memory)Numbered steps the model executes.
2Topology[REASONING TOPOLOGY] (reasoning) · [REASONING TOPOLOGY] (code) · [DETECTION TOPOLOGY] (anti-deception) · [PERCEPTION TOPOLOGY] (memory)DAG specification. See DAG syntax.
3Cognitive payloadAmplify: / Suppress: / Cognitive Style: / Elasticity: (all modes)Tendency vectors and execution-style hints.
4Verification[FALSIFICATION TEST] (reasoning) · [VERIFICATION] (code) · [INTEGRITY CHECK] (anti-deception) · [PERCEPTION CHECK] (memory)Self-check the model runs after drafting.
5Failure pattern[NEGATIVE GATE] (reasoning) · [CODE FAILURE] (code) · [DECEPTION PATTERN] (anti-deception) · [PERCEPTION FAILURE] (memory)The failure pattern to refuse.
6Correct shape[TARGET PATTERN] (reasoning) · [CORRECT PATTERN] (code) · [HONEST BEHAVIOR] (anti-deception) · [CLEAR SIGNAL] (memory)What a correct response looks like.

The same six-slot order holds for both dynamic and adaptive variants of every mode. In adaptive responses, the adapter LLM rewrites slots 1 and 2 (procedure and topology) with task-specific identifiers; slots 3-6 are returned verbatim.

DAG syntax

The topology block uses a flat string notation:

TokenMeaning
Sn:labelStep node. Numbered, sequential by default.
Gn{?}Decision gate. Branches --yes-> / --no->.
N{...}Negative anchor. Active across the whole branch; the labelled failure pattern is refused.
M{...}Meta-cognitive node. Model pauses, evaluates the trace, then RE-ENTERs at a named step.
FREEFORM{...}Escape path. Model exits the prescribed DAG when the plan stops fitting; returns to a step or OUT.
FIXED_POINT[...]A quantity held stable across the branch.
for_each: / LOOP[...]Bounded iteration.
C{expr}Computed value used downstream.
OUT:labelTerminal node.

The DAG is meant to be read by the LLM as a structured outline of the reasoning path, not executed by a host runtime. The labelled-step structure persists across long context windows where prose-only reasoning specifications lose retrieval salience.


Canonical example: dynamic vs adaptive on the same query

Query (used for both calls):

Evaluate whether a database migration plan that adds a NOT NULL column to a 50M-row table is safe under concurrent writes, given that the backfill strategy uses a trigger-based default.

The picker matched the same operation in both calls ("realistic duration estimation" with the Hofstadter buffer). The [NEGATIVE GATE], [TARGET PATTERN], [FALSIFICATION TEST], and [COGNITIVE PAYLOAD] fields are identical between the two responses (the adapter does not rewrite them). The [PROCEDURE] and [REASONING TOPOLOGY] fields differ: the adaptive response replaces abstract identifiers with task-specific ones.

Dynamic reasoning response (truncated to the differing fields)

[PROCEDURE]Step 1: Extract every duration estimate and identify its basis: historical data,expert judgment, or optimistic assumption. Step 2: Compare each estimate againsthistorical base rates or p90 benchmarks for similar tasks. Step 3: Flag estimatesbelow the historical median as likely optimistic. Step 4: Never accept best-caseestimates as planning targets. Do not anchor to initial optimistic numbers.Step 5: If an estimate lacks historical basis, simulate impact with a 1.5x-2.0xbuffer. If data exists, compute the variance-adjusted range. Verify the finaltimeline accounts for cascading delay propagation across dependent tasks.
[REASONING TOPOLOGY]S1:extract_duration_estimates -> N{accept_best_case_estimates_planning_targets}-> S2:identify_basis(historical|expert|assumption)-> FIXED_POINT[historical_base_rates]-> S3:compare(estimate_vs_p90_benchmark)-> G1{below_median?} --yes-> FLAG:likely_optimistic -> S4:apply_buffer(1.5x_to_2x) -> S3[LOOP]                       --no-> G2{lacks_historical_basis?} --yes-> S4b:simulate_with_buffer -> S3                                                          --no-> C{adjusted_range = base_rate_estimate +/- sqrt(variance) * z}                                                              -> S5:apply_adjusted_range                                                              -> S6:verify_cascade_delay                                                              -> OUT:realistic_timeline

Adaptive adaptive-reasoning response (same query, same picked operation)

[PROCEDURE]Step 1: Extract every duration estimate in the migration plan (DDL execution timefor adding NOT NULL column on 50M rows, backfill duration, trigger overhead perconcurrent write, total migration window) and identify its basis: historicalmigration data on similar table sizes, DBA expert judgment, or optimisticassumption assuming zero contention. Step 2: Compare each estimate againsthistorical base rates or p90 benchmarks for similar DDL operations on large tables(e.g., ALTER TABLE duration per million rows, trigger-induced latency underconcurrent write load). Step 3: Flag estimates below the historical median aslikely optimistic, e.g., assuming sub-second column addition without consideringlock escalation on a 50M-row table, or assuming trigger-based backfill addsnegligible overhead under concurrent write traffic. Step 4: Never accept best-caseestimates as planning targets. Do not anchor to initial optimistic numbers suchas "the NOT NULL addition will complete instantly" or "the trigger will not slowdown concurrent writes." Step 5: If an estimate lacks historical basis (e.g., noprior trigger-based backfill on a table this size), simulate impact with a1.5x-2.0x buffer for lock duration and write throughput degradation. If dataexists (e.g., past ALTER TABLE timings on this table), compute thevariance-adjusted range. Verify the final timeline accounts for cascading delaypropagation across dependent tasks (e.g., extended lock hold times blockingapplication queries, backfill slowdown under write contention propagating todownstream replication lag).
[REASONING TOPOLOGY]S1:extract_migration_duration_estimates(DDL_time|backfill_time|trigger_overhead|lock_hold_time)-> N{accept_best_case_estimates_planning_targets}-> S2:identify_basis(historical_migration_data|DBA_expert_judgment|optimistic_assumption)-> FIXED_POINT[historical_base_rates_for_DDL_on_large_tables]-> S3:compare(estimate_vs_p90_benchmark_for_ALTER_TABLE_and_trigger_overhead)-> G1{below_median_for_similar_migrations?} --yes-> FLAG:likely_optimistic(e.g.,assumes_zero_lock_contention)                                                 -> S4:apply_buffer(1.5x_to_2x_for_lock_duration_and_write_throughput)                                                 -> S3[LOOP]                                              --no-> G2{lacks_historical_basis_for_trigger_backfill_on_50M_table?}                                                       --yes-> S4b:simulate_with_buffer_for_concurrent_write_impact_and_lock_escalation                                                       --no--> C{adjusted_range = base_rate_migration_estimate +/- sqrt(variance) * z}                                                              -> S5:apply_adjusted_range_for_migration_window                                                              -> S6:verify_cascade_delay(lock_blocking_app_queries -> replication_lag -> downstream_consumers)                                                              -> OUT:realistic_migration_timeline

Fields shared by both responses (slots 3-6, unchanged by the adapter)

Returned in the canonical order: cognitive payload, falsification test, negative gate, target pattern.

[COGNITIVE PAYLOAD]Amplify: hofstadter buffer application; p90 baseline comparison; variance         multiplier scalingSuppress: best case anchoring; optimism biasCognitive Style: realistic duration estimationElasticity: coherence=risk adjusted timeline, expansion=conservative
[FALSIFICATION TEST]If time estimates reflect only the best-case scenario without verifying applyingany buffer multiplier, duration calibration has defaulted to optimism.
[NEGATIVE GATE]The database migration will take two weeks: that's our best-case estimate and theteam is experienced, so there's no reason to add buffer. We'll hit the deadlineif everything goes according to plan.
[TARGET PATTERN]Challenge the two-week estimate: what do similar migrations actually take? If pastprojects averaged four weeks at p90, the best-case anchor is dangerously optimistic.Apply a variance multiplier for schema complexity, data volume, and rollbacktesting: build buffer from the full distribution, not the happy path.

This is the contract: dynamic returns the matched abstract operation; adaptive returns the same operation with PROCEDURE and topology nodes rewritten in terms of the caller's task (DDL execution time, lock_blocking_app_queries, trigger-based backfill on a table this size) while preserving the operation's structural identity, the safety language, and the cognitive payload verbatim.


Configuration

VariableRequiredPurpose
EJENTUM_API_KEYyesAPI key from ejentum.com/pricing.
EJENTUM_API_URLnoOverride the upstream URL. Default: https://api.ejentum.com/harness/.

The MCP wrapper is stateless. No local logging, no telemetry, no third-party calls. The upstream API counts requests against the key for billing; the request body (the query string) is consumed for retrieval and not retained beyond the response.


Errors

StatusCause
401 UnauthorizedEJENTUM_API_KEY is unset, wrong, or expired.
403 ForbiddenAdaptive mode requested on a tier that does not include it (trial or unrecognised).
429 Rate limit exceededTier quota for the period exhausted.
Tool absent from clientClient did not reload after config change. Fully quit and reopen; on Claude Desktop check Help → Logs.
EJENTUM_API_KEY is not set from the wrapperClient did not pass the env block to the spawned MCP process.

Local development

bash
git clone https://github.com/ejentum/ejentum-mcp.gitcd ejentum-mcpnpm installcp .env.example .env       # paste your EJENTUM_API_KEYnpm run dev

Smoke test against the live API:

bash
npm run build && npm run test:smoke

Interactive testing with MCP Inspector:

bash
npx @modelcontextprotocol/inspector npm run dev

Listings

[ejentum-mcp MCP server]

Links

License

MIT. See LICENSE.

來源:README.md,提交 5cd30e8

工具

4

ejentum_scaffold

Retrieve a deterministic reasoning scaffold (Reasoning-Augmented Retrieval) to prevent hallucinations, causal inversion, and compounding multi-step failures.

輸入參數modequery必填stack_size

ejentum_domains

List the 6 invariant cognitive failure dimensions and primary failure modes mapped by Ejentum.

無需輸入參數。

ejentum_graph

Traverse the 933-edge cognitive synergy graph to compose a multi-hop Cognitive Directed Acyclic Graph (DAG) with Root, Prerequisite, Amplifier, and Fallback operators.

輸入參數depthqueryability_id

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分