@arkheia/mcp-server 0.1.1 → 0.1.2

package/README.md

@@ -10,6 +10,8 @@ Free tier included (1,500 detections/month).
 ```bash
 git clone https://github.com/arkheiaai/arkheia-mcp.git ~/.arkheia-mcp
 cd ~/.arkheia-mcp
+python -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
 pip install -r requirements.txt
 ```
 
@@ -31,7 +33,7 @@ Edit your config file:
 {
   "mcpServers": {
     "arkheia": {
-      "command": "python",
+      "command": "~/.arkheia-mcp/.venv/bin/python",
       "args": ["-m", "mcp_server.server"],
       "cwd": "~/.arkheia-mcp",
       "env": {
@@ -43,11 +45,15 @@ Edit your config file:
 }
 ```
 
-On Windows, replace `~/.arkheia-mcp` with the full path (e.g. `C:/Users/YourName/.arkheia-mcp`).
+On Windows, replace `~/.arkheia-mcp` with the full path using forward slashes (e.g. `C:/Users/YourName/.arkheia-mcp`) and use `.venv/Scripts/python` instead of `.venv/bin/python`.
 
-### 4. Restart Claude
+### 4. Restart Claude and verify
 
-The `arkheia_verify` and `arkheia_audit_log` tools will appear automatically.
+Restart Claude Desktop (quit and reopen, not just close window). The Arkheia tools will appear automatically.
+
+To verify, ask Claude: *"Use arkheia_verify to check this response for fabrication: 'The Eiffel Tower is located in Berlin, Germany.'"*
+
+You should see a detection result with a risk level and confidence score.
 
 ## Tools
 

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.2",
   "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": {