eruka-mcp
MCP (Model Context Protocol) server for Eruka — anti-hallucination context memory for AI agents.
什么是Eruka？
Eruka是一个知识引擎，可以跟踪AI代理知道什么，不知道什么，以及他们永远不应该制造什么。它提供：
- 4知识状态：确认、推断、不确定、未知
- 间隙检测：在生成之前识别缺失的信息
- 约束注入：LLM提示的“请勿制造”指令
- 知识衰退：信心随着时间的推移而下降，事实变得不确定
- 质量评分：6层幻觉检测管道
安装
cargo install eruka-mcp或者从源代码构建：
git clone https://github.com/dirmacs/eruka-mcp
cd eruka-mcp
cargo build --release设置
eruka mcp使用两个后端：
本地模式-- openeruka
在本地运行开源的Eruka服务器——单二进制、SQLite后端、零基础设施。
# 1. Install the local server
cargo install openeruka-server # installs the `openeruka` binary
# 2. Start it
openeruka serve # runs at http://localhost:8080
# 3. Run eruka-mcp — connects to localhost:8080 by default
eruka-mcp完整文档：
管理模式--eruka.dirmacs.com
- 注册地址： eruka.dirmacs.com
- 创建服务密钥（“设置”>“API密钥”）
- 设置密钥：
export ERUKA_API_URL=https://eruka.dirmacs.com
export ERUKA_API_KEY=eruka_sk_...用法
克劳德桌面
本地模式 （openeruka--在本地运行，不需要服务）：
{
"mcpServers": {
"eruka": {
"command": "eruka-mcp"
}
}
}管理模式 （eruka.dimacs.com）：
{
"mcpServers": {
"eruka": {
"command": "eruka-mcp",
"env": {
"ERUKA_API_URL": "https://eruka.dirmacs.com",
"ERUKA_API_KEY": "eruka_sk_..."
}
}
}
}克劳德代码
本地模式：
claude mcp add eruka eruka-mcp管理模式：
claude mcp add eruka eruka-mcp \
-e ERUKA_API_URL=https://eruka.dirmacs.com \
-e ERUKA_API_KEY=eruka_sk_...流式HTTP传输（远程MCP）
作为claude.ai web、Cursor或任何支持HTTP的MCP客户端的远程MCP服务器运行：
eruka-mcp --transport sse --port 8080这将在以下位置启动可流式HTTP服务器（MCP规范2025-03-26） http://localhost:8080/mcp:
POST /mcp--JSON-RPC 2.0请求（初始化、工具/列表、工具/调用）GET /mcp--SSE通知流- 会话管理通过
Mcp-Session-Id头球
Claude.ai网站
在以下位置使用托管端点 https://eruka.dirmacs.com/mcp:
- 转到claude.ai→ 设置→ 连接器→ 添加自定义连接器
- 输入URL:
https://eruka.dirmacs.com/mcp - 使用您的Eruka凭据进行身份验证（OAuth）
- 所有18个工具都是自动可用的
直接HTTP测试
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'工具
| 工具 | 描述 | 层级 |
|---|---|---|
eruka_get_context | 按架构路径检索字段 | 免费 |
eruka_search_context | 跨所有上下文的语义搜索 | 免费 |
eruka_get_completeness | 按类别细分的完整性评分 | 免费 |
eruka_get_gaps | 按影响列出知识差距 | 免费 |
eruka_write_context | 写入或更新字段 | 免费 |
eruka_get_voice | 检索品牌语音指南 | 免费 |
eruka_detect_gaps | 任务类型的运行间隙检测 | 免费 |
eruka_get_constraint | 生成抗幻觉约束文本 | Pro |
eruka_get_related | 浏览知识图谱 | 免费 |
eruka_add_relationship | 在知识图中创建键入边 | 免费 |
eruka_get_context_compressed | 令牌高效压缩上下文 | 免费 |
eruka_get_context_cached | 基于Diff的缓存和会话跟踪（节省20-30%的令牌） | 免费 |
eruka_prefetch | 代理生命周期：预取当前回合的上下文 | 免费 |
eruka_sync_turn | 持续对话转向上下文存储 | 免费 |
eruka_on_pre_compress | 在上下文窗口压缩之前保存见解 | 免费 |
eruka_export_context | 将所有上下文导出为可移植JSON包 | 免费 |
eruka_query_temporal | 查询某个时间点的上下文 | Pro |
eruka_research_gap | 汽车研究和填补知识空白 | Pro |
CLI别名
对于较短的命令，请添加别名：
alias eruka='eruka-mcp'
# Then: eruka get "*", eruka write ..., eruka healthCLI命令
eruka-mcp既可以作为mcp服务器，也可以作为独立的CLI工具。如果没有子命令，它将作为MCP服务器运行（向后兼容）。
# Read all context
eruka-mcp get "*"
# Read a specific field
eruka-mcp get "identity/company_name"
# Write a field
eruka-mcp write "identity/mission" "Build anti-hallucination infrastructure"
# Write with custom confidence and source
eruka-mcp write "market/tam" '$4.2B' --confidence 0.7 --source agent_inference
# Search
eruka-mcp search "revenue"
# Completeness report
eruka-mcp completeness
# Knowledge gaps
eruka-mcp gaps
# Health check
eruka-mcp health
# JSON output (for scripting)
eruka-mcp get "*" --format json
eruka-mcp completeness --format json所有CLI命令都使用相同的 ERUKA_API_KEY 和 ERUKA_API_URL 环境变量作为MCP服务器。
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
ERUKA_API_URL | 后端URL——本地openeruka或托管服务 | http://localhost:8080 |
ERUKA_API_KEY | 服务密钥-- "local" 对于openeruka来说， eruka_sk_... 对于管理 | local |
CLI 参考
eruka-mcp [OPTIONS] [COMMAND]
Commands:
get Read context fields
write Write a context field
search Search context
completeness Show completeness report
gaps List knowledge gaps
health Check API health
Options:
--api-url Eruka API URL [env: ERUKA_API_URL]
--api-key Service key [env: ERUKA_API_KEY]
--tier Tier override [default: free]
--transport stdio or sse [default: stdio]
--port
SSE port [default: 8080]
--format Output: text or json [default: text]
--debug Debug logging许可证
麻省理工学院