@arkheia/mcp-server 0.1.1 → 0.1.3

package/README.md

@@ -1,19 +1,18 @@
-# Arkheia MCP Server — Fabrication Detection for LLMs
+# Arkheia MCP Server — Fabrication Detection for AI Agents
 
-Detect fabrication (hallucination) in any LLM output.
-Free tier included (1,500 detections/month).
+Know when your AI is making things up.
 
-## Quick Start
+Arkheia screens model responses for fabrication using behavioural fingerprinting. Works with Claude, GPT, Gemini, Grok, Llama, Mistral, and 30+ other models. One tool call. Real-time risk scoring.
+
+Free tier: 1,500 detections/month. No credit card.
 
-### 1. Clone and install
+## Quick Start
 
 ```bash
-git clone https://github.com/arkheiaai/arkheia-mcp.git ~/.arkheia-mcp
-cd ~/.arkheia-mcp
-pip install -r requirements.txt
+npx @arkheia/mcp-server
 ```
 
-### 2. Get an API key (free)
+Get a free API key:
 
 ```bash
 curl -X POST https://arkheia-proxy-production.up.railway.app/v1/provision \
@@ -21,11 +20,7 @@ curl -X POST https://arkheia-proxy-production.up.railway.app/v1/provision \
   -d '{"email": "you@example.com"}'
 ```
 
-### 3. Add to Claude Desktop
-
-Edit your config file:
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+Add to your agent config (Claude Code, Claude Desktop, Cursor, or any MCP-compatible tool):
 
 ```json
 {
@@ -33,52 +28,62 @@ Edit your config file:
     "arkheia": {
       "command": "python",
       "args": ["-m", "mcp_server.server"],
-      "cwd": "~/.arkheia-mcp",
+      "cwd": "~/.arkheia/mcp",
       "env": {
-        "PYTHONPATH": "~/.arkheia-mcp",
-        "ARKHEIA_API_KEY": "ak_live_YOUR_KEY_HERE"
+        "PYTHONPATH": "~/.arkheia/mcp",
+        "ARKHEIA_API_KEY": "ak_live_your_key_here"
       }
     }
   }
 }
 ```
 
-On Windows, replace `~/.arkheia-mcp` with the full path (e.g. `C:/Users/YourName/.arkheia-mcp`).
+Restart your agent. Then ask it:
 
-### 4. Restart Claude
+> "Use arkheia_verify to check this response: The Kafka 4.1 ConsumerLease API introduces a lease-based partition ownership model."
 
-The `arkheia_verify` and `arkheia_audit_log` tools will appear automatically.
+It should flag this as **HIGH** risk — because the Kafka 4.1 ConsumerLease API doesn't exist.
 
-## Tools
+## What You Get
 
 | Tool | Description |
 |------|-------------|
-| `arkheia_verify` | Score any model output for fabrication risk (LOW/MEDIUM/HIGH) |
-| `arkheia_audit_log` | Review detection history |
-| `run_grok` | Call xAI Grok + screen for fabrication |
-| `run_gemini` | Call Google Gemini + screen for fabrication |
-| `run_together` | Call Together AI (Kimi, DeepSeek) + screen |
+| `arkheia_verify` | Score any model response for fabrication risk (LOW/MEDIUM/HIGH) |
+| `arkheia_audit_log` | Review your detection history |
+| `run_grok` | Call Grok + screen for fabrication |
+| `run_gemini` | Call Gemini + screen for fabrication |
 | `run_ollama` | Call local Ollama model + screen |
-| `memory_store` / `memory_retrieve` / `memory_relate` | Persistent knowledge graph |
+| `run_together` | Call Together AI (Kimi, DeepSeek) + screen |
+
+## 35+ Model Profiles
+
+GPT-4o, GPT-5.4, Claude Opus/Sonnet/Haiku, Gemini 2.5/3.0, Grok 4, Llama, Mixtral, CodeLlama, Falcon, Phi4, Kimi K2.5, and more. If your model isn't listed, [let us know](mailto:dmurfet@arkheia.ai).
 
 ## Pricing
 
-- **Free:** 1,500 detections/month (no credit card)
-- **Single Contributor:** $99/month (unlimited)
-- **Professional:** $499/month (20 concurrent)
-- **Team:** $1,999/month (50 concurrent)
+| Plan | Price | Detections |
+|------|-------|------------|
+| Free | $0 | 1,500/month |
+| Single Contributor | $99/month | Unlimited |
+| Professional | $499/month | Unlimited |
+| Team | $1,999/month | Unlimited |
+
+## Full Documentation
 
-## Requirements
+See the [GitHub repo](https://github.com/arkheiaai/arkheia-mcp) for:
+- Complete setup guide for all agents
+- CLAUDE.md template for automatic detection across projects
+- Multi-agent quorum pattern
+- Test prompts and examples
 
-- Python 3.10+
-- Git
+## Feedback
 
-## Full Setup Guide
+- **GitHub Issues:** https://github.com/arkheiaai/arkheia-mcp/issues
+- **Email:** dmurfet@arkheia.ai
 
-See [AGENTS.md](https://github.com/arkheiaai/arkheia-mcp/blob/master/AGENTS.md) for detailed instructions, troubleshooting, and environment variables.
+Every message is read by the founder.
 
 ## Links
 
 - Website: https://arkheia.ai
 - GitHub: https://github.com/arkheiaai/arkheia-mcp
-- Support: support@arkheia.ai

package/bin/arkheia-mcp.js

@@ -22,13 +22,47 @@ const { spawn, execSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
 
-const PYTHON_DIR = path.join(__dirname, "..", "python");
-const REQUIREMENTS = path.join(PYTHON_DIR, "requirements.txt");
-const VENV_DIR = path.join(
+const ARKHEIA_HOME = path.join(
   process.env.HOME || process.env.USERPROFILE || "/tmp",
-  ".arkheia",
-  "venv"
+  ".arkheia"
 );
+const REPO_DIR = path.join(ARKHEIA_HOME, "mcp");
+const BUNDLED_PYTHON_DIR = path.join(__dirname, "..", "python");
+const VENV_DIR = path.join(ARKHEIA_HOME, "venv");
+
+// Determine the real Python source: cloned repo > bundled package
+function getServerDir() {
+  // If repo already cloned, use it
+  if (fs.existsSync(path.join(REPO_DIR, "mcp_server", "server.py"))) {
+    return REPO_DIR;
+  }
+  // If bundled package has the server code, use it
+  if (fs.existsSync(path.join(BUNDLED_PYTHON_DIR, "mcp_server", "server.py"))) {
+    return BUNDLED_PYTHON_DIR;
+  }
+  // Neither exists — clone the repo
+  process.stderr.write("[arkheia] Server code not found. Cloning from GitHub...\n");
+  try {
+    if (!fs.existsSync(ARKHEIA_HOME)) fs.mkdirSync(ARKHEIA_HOME, { recursive: true });
+    execSync(`git clone --depth 1 https://github.com/arkheiaai/arkheia-mcp.git "${REPO_DIR}"`, {
+      stdio: "inherit",
+      timeout: 60000,
+    });
+    process.stderr.write("[arkheia] Repository cloned successfully.\n");
+    return REPO_DIR;
+  } catch (err) {
+    process.stderr.write(
+      `[arkheia] Error: Could not clone repository: ${err.message}\n` +
+      "Manual install: git clone https://github.com/arkheiaai/arkheia-mcp.git ~/.arkheia/mcp\n"
+    );
+    process.exit(1);
+  }
+}
+
+const PYTHON_DIR = getServerDir();
+const REQUIREMENTS = fs.existsSync(path.join(PYTHON_DIR, "mcp_server", "requirements.txt"))
+  ? path.join(PYTHON_DIR, "mcp_server", "requirements.txt")
+  : path.join(PYTHON_DIR, "requirements.txt");
 
 function findPython() {
   const candidates = ["python3", "python"];
@@ -139,16 +173,15 @@ function main() {
   }
 
   // Spawn the MCP server with stdio transport
-  const serverDir = PYTHON_DIR;
   const child = spawn(
     venvPython,
     ["-m", "mcp_server.server"],
     {
-      cwd: serverDir,
+      cwd: PYTHON_DIR,
       stdio: ["pipe", "pipe", "inherit"], // stdin/stdout piped, stderr inherited
       env: {
         ...process.env,
-        PYTHONPATH: serverDir,
+        PYTHONPATH: PYTHON_DIR,
       },
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkheia/mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "mcpName": "io.github.arkheiaai/mcp-server",
   "description": "Arkheia MCP Server — Fabrication detection for LLM outputs. Detect hallucination in any model's output with a single tool call.",
   "bin": {