Skip to content

dirmacs/eruka-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

eruka-mcp

eruka-mcp

MCP (Model Context Protocol) server for Eruka — anti-hallucination context memory for AI agents.

What is Eruka?

Eruka is a knowledge engine that tracks what AI agents know, what they don't know, and what they should never fabricate. It provides:

  • 4 Knowledge States: CONFIRMED, INFERRED, UNCERTAIN, UNKNOWN
  • Gap Detection: identifies missing information before generation
  • Constraint Injection: "DO NOT FABRICATE" directives for LLM prompts
  • Knowledge Decay: confidence degrades over time, facts become UNCERTAIN
  • Quality Scoring: 6-layer hallucination detection pipeline

Install

cargo install eruka-mcp

Or build from source:

git clone https://github.com/dirmacs/eruka-mcp
cd eruka-mcp
cargo build --release

Setup

  1. Sign up at eruka.dirmacs.com
  2. Create a service key (Settings > API Keys)
  3. Set your key:
export ERUKA_API_KEY=eruka_sk_...

Usage

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "eruka": {
      "command": "eruka-mcp",
      "env": {
        "ERUKA_API_KEY": "eruka_sk_..."
      }
    }
  }
}

Claude Code

claude mcp add eruka eruka-mcp -e ERUKA_API_KEY=eruka_sk_...

SSE Transport (web clients)

eruka-mcp --transport sse --port 8080

Tools

Tool Description Tier
eruka_get_context Retrieve fields by schema path Free
eruka_search_context Semantic search across all context Free
eruka_get_completeness Completeness score with per-category breakdown Free
eruka_get_gaps List knowledge gaps sorted by impact Free
eruka_write_context Write or update a field Free
eruka_get_voice Retrieve brand voice guidelines Free
eruka_detect_gaps Run gap detection for a task type Free
eruka_get_constraint Generate anti-hallucination constraint text Pro
eruka_get_related Traverse the knowledge graph Free
eruka_add_relationship Create typed edges in the knowledge graph Free
eruka_get_context_compressed Token-efficient compressed context Free
eruka_query_temporal Query context at a point in time Pro
eruka_research_gap Auto-research and fill knowledge gaps Pro

CLI Alias

For shorter commands, add an alias:

alias eruka='eruka-mcp'
# Then: eruka get "*", eruka write ..., eruka health

CLI Commands (v0.2.1+)

eruka-mcp works as both an MCP server AND a standalone CLI tool. Without a subcommand, it runs as an MCP server (backward compatible).

# 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

All CLI commands use the same ERUKA_API_KEY and ERUKA_API_URL environment variables as the MCP server.

Environment Variables

Variable Description Default
ERUKA_API_KEY Service key (required)
ERUKA_API_URL Eruka API URL https://eruka.dirmacs.com

CLI Reference

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 <URL>        Eruka API URL [env: ERUKA_API_URL]
      --api-key <KEY>        Service key [env: ERUKA_API_KEY]
      --tier <TIER>          Tier override [default: free]
      --transport <MODE>     stdio or sse [default: stdio]
      --port <PORT>          SSE port [default: 8080]
      --format <FMT>         Output: text or json [default: text]
      --debug                Debug logging

License

MIT