@arkheia/mcp-server 0.1.10 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +109 -177
- package/bin/arkheia-mcp.js +207 -0
- package/package.json +26 -26
- package/python/mcp_server/__init__.py +0 -0
- package/python/requirements.txt +4 -0
- package/scripts/build.js +33 -33
- package/scripts/setup.js +130 -179
- package/CLAUDE_MD_TEMPLATE.md +0 -33
- package/dist/index.js +0 -260
- package/dist/memory.js +0 -187
- package/dist/providers.js +0 -320
- package/dist/proxy-client.js +0 -219
- package/dist/tool-registry.js +0 -90
- package/scripts/setup-claude.js +0 -163
package/README.md
CHANGED
|
@@ -1,177 +1,109 @@
|
|
|
1
|
-
# Arkheia MCP Server — Fabrication Detection for AI Agents
|
|
2
|
-
|
|
3
|
-
Know when your AI is making things up.
|
|
4
|
-
|
|
5
|
-
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.
|
|
6
|
-
|
|
7
|
-
Free tier: 1,500 detections/month. No credit card.
|
|
8
|
-
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
## What You Get
|
|
111
|
-
|
|
112
|
-
| Tool | Description |
|
|
113
|
-
|------|-------------|
|
|
114
|
-
| `arkheia_verify` | Score any model response for fabrication risk (LOW/MEDIUM/HIGH) |
|
|
115
|
-
| `arkheia_audit_log` | Review your detection history |
|
|
116
|
-
| `run_grok` | Call Grok + screen for fabrication |
|
|
117
|
-
| `run_gemini` | Call Gemini + screen for fabrication |
|
|
118
|
-
| `run_ollama` | Call local Ollama model + screen |
|
|
119
|
-
| `run_together` | Call Together AI (Kimi, DeepSeek) + screen |
|
|
120
|
-
| `memory_store` | Persistent knowledge graph — upsert entity |
|
|
121
|
-
| `memory_retrieve` | Knowledge graph lookup |
|
|
122
|
-
| `memory_relate` | Create relationship between entities |
|
|
123
|
-
|
|
124
|
-
## 35+ Model Profiles
|
|
125
|
-
|
|
126
|
-
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).
|
|
127
|
-
|
|
128
|
-
## Pricing
|
|
129
|
-
|
|
130
|
-
| Plan | Price | Detections |
|
|
131
|
-
|------|-------|------------|
|
|
132
|
-
| Free | $0 | 1,500/month |
|
|
133
|
-
| Single Contributor | $99/month | Unlimited |
|
|
134
|
-
| Professional | $499/month | Unlimited |
|
|
135
|
-
| Team | $1,999/month | Unlimited |
|
|
136
|
-
|
|
137
|
-
Manage your account at [arkheia.ai/mcp/account](https://arkheia.ai/mcp/account).
|
|
138
|
-
|
|
139
|
-
## Where API keys are stored
|
|
140
|
-
|
|
141
|
-
| CLI | Config file | Key location |
|
|
142
|
-
|-----|-------------|-------------|
|
|
143
|
-
| Claude Code | `~/.claude.json` | `mcpServers.arkheia.env.ARKHEIA_API_KEY` |
|
|
144
|
-
| Codex | `~/.codex/config.toml` | `[mcp_servers.arkheia.env]` section |
|
|
145
|
-
| Gemini | `~/.gemini/settings.json` | `mcpServers.arkheia.env.ARKHEIA_API_KEY` |
|
|
146
|
-
| Grok | `~/.grok/settings.json` | `mcpServers.arkheia.transport.env.ARKHEIA_API_KEY` |
|
|
147
|
-
|
|
148
|
-
## Troubleshooting
|
|
149
|
-
|
|
150
|
-
**"Python 3.10+ is required but not found"** — Install Python 3.12: `brew install python@3.12` (macOS) or download from [python.org](https://python.org).
|
|
151
|
-
|
|
152
|
-
**"No module named pip"** — Your Python installation has broken pip (common with Python 3.14 on macOS). Delete `~/.arkheia/venv` and switch to Python 3.12: `brew install python@3.12`.
|
|
153
|
-
|
|
154
|
-
**Server registered but tools not showing** — Restart your CLI session. MCP registrations are not hot-reloaded.
|
|
155
|
-
|
|
156
|
-
**API key rejected** — Check for trailing whitespace or `\r` characters. If your env file was created on Windows, run `dos2unix` on it. The server will warn about this on startup.
|
|
157
|
-
|
|
158
|
-
## Full Documentation
|
|
159
|
-
|
|
160
|
-
See the [GitHub repo](https://github.com/arkheiaai/arkheia-mcp) for:
|
|
161
|
-
- Complete setup guide for all agents
|
|
162
|
-
- CLAUDE.md template for automatic detection across projects
|
|
163
|
-
- Multi-agent quorum pattern
|
|
164
|
-
- Test prompts and examples
|
|
165
|
-
|
|
166
|
-
## Feedback
|
|
167
|
-
|
|
168
|
-
- **GitHub Issues:** https://github.com/arkheiaai/arkheia-mcp/issues
|
|
169
|
-
- **Email:** dmurfet@arkheia.ai
|
|
170
|
-
|
|
171
|
-
Every message is read by the founder.
|
|
172
|
-
|
|
173
|
-
## Links
|
|
174
|
-
|
|
175
|
-
- Website: https://arkheia.ai
|
|
176
|
-
- MCP Account: https://arkheia.ai/mcp/account
|
|
177
|
-
- GitHub: https://github.com/arkheiaai/arkheia-mcp
|
|
1
|
+
# Arkheia MCP Server — Fabrication Detection for AI Agents
|
|
2
|
+
|
|
3
|
+
Know when your AI is making things up.
|
|
4
|
+
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
Free tier: 1,500 detections/month. No credit card.
|
|
8
|
+
|
|
9
|
+
## Quick Start
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npx @arkheia/mcp-server
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Get a free API key:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
curl -X POST https://arkheia-proxy-production.up.railway.app/v1/provision \
|
|
19
|
+
-H "Content-Type: application/json" \
|
|
20
|
+
-d '{"email": "you@example.com"}'
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Add to your agent config (Claude Code, Claude Desktop, Cursor, or any MCP-compatible tool):
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"mcpServers": {
|
|
28
|
+
"arkheia": {
|
|
29
|
+
"command": "python",
|
|
30
|
+
"args": ["-m", "mcp_server.server"],
|
|
31
|
+
"cwd": "~/.arkheia/mcp",
|
|
32
|
+
"env": {
|
|
33
|
+
"PYTHONPATH": "~/.arkheia/mcp",
|
|
34
|
+
"ARKHEIA_API_KEY": "ak_live_your_key_here"
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Restart your agent. Then ask it:
|
|
42
|
+
|
|
43
|
+
> "Use arkheia_verify to check this response: The Kafka 4.1 ConsumerLease API introduces a lease-based partition ownership model."
|
|
44
|
+
|
|
45
|
+
It should flag this as **HIGH** risk — because the Kafka 4.1 ConsumerLease API doesn't exist.
|
|
46
|
+
|
|
47
|
+
## Live CLI Routing
|
|
48
|
+
|
|
49
|
+
MCP gives agents a portable `arkheia_verify` tool. For live vendor CLI detection, route the CLI through the Arkheia API Proxy too.
|
|
50
|
+
|
|
51
|
+
Codex subscription sessions need both transports routed:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
codex \
|
|
55
|
+
-c 'chatgpt_base_url="https://arkheia-proxy-production.up.railway.app/backend-api/"' \
|
|
56
|
+
-c 'openai_base_url="https://arkheia-proxy-production.up.railway.app/v1"'
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
API-key based Codex sessions can use the OpenAI-compatible route:
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
OPENAI_BASE_URL=https://arkheia-proxy-production.up.railway.app/v1 codex
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Use MCP for targeted checks and the proxy for automatic workflow-level detection.
|
|
66
|
+
|
|
67
|
+
## What You Get
|
|
68
|
+
|
|
69
|
+
| Tool | Description |
|
|
70
|
+
|------|-------------|
|
|
71
|
+
| `arkheia_verify` | Score any model response for fabrication risk (LOW/MEDIUM/HIGH) |
|
|
72
|
+
| `arkheia_audit_log` | Review your detection history |
|
|
73
|
+
| `run_grok` | Call Grok + screen for fabrication |
|
|
74
|
+
| `run_gemini` | Call Gemini + screen for fabrication |
|
|
75
|
+
| `run_ollama` | Call local Ollama model + screen |
|
|
76
|
+
| `run_together` | Call Together AI (Kimi, DeepSeek) + screen |
|
|
77
|
+
|
|
78
|
+
## 35+ Model Profiles
|
|
79
|
+
|
|
80
|
+
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).
|
|
81
|
+
|
|
82
|
+
## Pricing
|
|
83
|
+
|
|
84
|
+
| Plan | Price | Detections |
|
|
85
|
+
|------|-------|------------|
|
|
86
|
+
| Free | $0 | 1,500/month |
|
|
87
|
+
| Single Contributor | $99/month | Unlimited |
|
|
88
|
+
| Professional | $499/month | Unlimited |
|
|
89
|
+
| Team | $1,999/month | Unlimited |
|
|
90
|
+
|
|
91
|
+
## Full Documentation
|
|
92
|
+
|
|
93
|
+
See the [GitHub repo](https://github.com/arkheiaai/arkheia-mcp) for:
|
|
94
|
+
- Complete setup guide for all agents
|
|
95
|
+
- CLAUDE.md template for automatic detection across projects
|
|
96
|
+
- Multi-agent quorum pattern
|
|
97
|
+
- Test prompts and examples
|
|
98
|
+
|
|
99
|
+
## Feedback
|
|
100
|
+
|
|
101
|
+
- **GitHub Issues:** https://github.com/arkheiaai/arkheia-mcp/issues
|
|
102
|
+
- **Email:** dmurfet@arkheia.ai
|
|
103
|
+
|
|
104
|
+
Every message is read by the founder.
|
|
105
|
+
|
|
106
|
+
## Links
|
|
107
|
+
|
|
108
|
+
- Website: https://arkheia.ai
|
|
109
|
+
- GitHub: https://github.com/arkheiaai/arkheia-mcp
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Arkheia MCP Server — thin Node wrapper that spawns the Python MCP server.
|
|
4
|
+
*
|
|
5
|
+
* This wrapper exists so that MCP clients can install via:
|
|
6
|
+
* npx @arkheia/mcp-server
|
|
7
|
+
* npm install -g @arkheia/mcp-server
|
|
8
|
+
*
|
|
9
|
+
* It:
|
|
10
|
+
* 1. Locates a Python 3.10+ interpreter
|
|
11
|
+
* 2. Ensures mcp_server dependencies are installed (pip install)
|
|
12
|
+
* 3. Spawns `python -m mcp_server.server` with stdio transport
|
|
13
|
+
* 4. Forwards stdin/stdout/stderr (MCP uses stdio)
|
|
14
|
+
*
|
|
15
|
+
* Environment variables:
|
|
16
|
+
* ARKHEIA_API_KEY — API key for hosted detection (required)
|
|
17
|
+
* ARKHEIA_PROXY_URL — Local proxy URL (optional, for enterprise)
|
|
18
|
+
* ARKHEIA_HOSTED_URL — Hosted API URL (default: https://arkheia-proxy-production.up.railway.app)
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
const { spawn, execSync } = require("child_process");
|
|
22
|
+
const path = require("path");
|
|
23
|
+
const fs = require("fs");
|
|
24
|
+
|
|
25
|
+
const ARKHEIA_HOME = path.join(
|
|
26
|
+
process.env.HOME || process.env.USERPROFILE || "/tmp",
|
|
27
|
+
".arkheia"
|
|
28
|
+
);
|
|
29
|
+
const REPO_DIR = path.join(ARKHEIA_HOME, "mcp");
|
|
30
|
+
const BUNDLED_PYTHON_DIR = path.join(__dirname, "..", "python");
|
|
31
|
+
const VENV_DIR = path.join(ARKHEIA_HOME, "venv");
|
|
32
|
+
|
|
33
|
+
// Determine the real Python source: cloned repo > bundled package
|
|
34
|
+
function getServerDir() {
|
|
35
|
+
// If repo already cloned, use it
|
|
36
|
+
if (fs.existsSync(path.join(REPO_DIR, "mcp_server", "server.py"))) {
|
|
37
|
+
return REPO_DIR;
|
|
38
|
+
}
|
|
39
|
+
// If bundled package has the server code, use it
|
|
40
|
+
if (fs.existsSync(path.join(BUNDLED_PYTHON_DIR, "mcp_server", "server.py"))) {
|
|
41
|
+
return BUNDLED_PYTHON_DIR;
|
|
42
|
+
}
|
|
43
|
+
// Neither exists — clone the repo
|
|
44
|
+
process.stderr.write("[arkheia] Server code not found. Cloning from GitHub...\n");
|
|
45
|
+
try {
|
|
46
|
+
if (!fs.existsSync(ARKHEIA_HOME)) fs.mkdirSync(ARKHEIA_HOME, { recursive: true });
|
|
47
|
+
execSync(`git clone --depth 1 https://github.com/arkheiaai/arkheia-mcp.git "${REPO_DIR}"`, {
|
|
48
|
+
stdio: "inherit",
|
|
49
|
+
timeout: 60000,
|
|
50
|
+
});
|
|
51
|
+
process.stderr.write("[arkheia] Repository cloned successfully.\n");
|
|
52
|
+
return REPO_DIR;
|
|
53
|
+
} catch (err) {
|
|
54
|
+
process.stderr.write(
|
|
55
|
+
`[arkheia] Error: Could not clone repository: ${err.message}\n` +
|
|
56
|
+
"Manual install: git clone https://github.com/arkheiaai/arkheia-mcp.git ~/.arkheia/mcp\n"
|
|
57
|
+
);
|
|
58
|
+
process.exit(1);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const PYTHON_DIR = getServerDir();
|
|
63
|
+
const REQUIREMENTS = fs.existsSync(path.join(PYTHON_DIR, "mcp_server", "requirements.txt"))
|
|
64
|
+
? path.join(PYTHON_DIR, "mcp_server", "requirements.txt")
|
|
65
|
+
: path.join(PYTHON_DIR, "requirements.txt");
|
|
66
|
+
|
|
67
|
+
function findPython() {
|
|
68
|
+
const candidates = ["python3", "python"];
|
|
69
|
+
for (const cmd of candidates) {
|
|
70
|
+
try {
|
|
71
|
+
const version = execSync(`${cmd} --version 2>&1`, {
|
|
72
|
+
encoding: "utf-8",
|
|
73
|
+
timeout: 5000,
|
|
74
|
+
}).trim();
|
|
75
|
+
const match = version.match(/Python (\d+)\.(\d+)/);
|
|
76
|
+
if (match && parseInt(match[1]) >= 3 && parseInt(match[2]) >= 10) {
|
|
77
|
+
return cmd;
|
|
78
|
+
}
|
|
79
|
+
} catch {
|
|
80
|
+
// Try next candidate
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return null;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
function ensureVenv(python) {
|
|
87
|
+
const venvPython =
|
|
88
|
+
process.platform === "win32"
|
|
89
|
+
? path.join(VENV_DIR, "Scripts", "python.exe")
|
|
90
|
+
: path.join(VENV_DIR, "bin", "python");
|
|
91
|
+
|
|
92
|
+
if (!fs.existsSync(venvPython)) {
|
|
93
|
+
process.stderr.write("[arkheia] Creating virtual environment...\n");
|
|
94
|
+
execSync(`${python} -m venv "${VENV_DIR}"`, { stdio: "inherit" });
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
return venvPython;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
function installDeps(venvPython) {
|
|
101
|
+
const marker = path.join(VENV_DIR, ".arkheia-deps-installed");
|
|
102
|
+
if (fs.existsSync(marker)) {
|
|
103
|
+
return; // Already installed
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
process.stderr.write("[arkheia] Installing dependencies...\n");
|
|
107
|
+
execSync(`"${venvPython}" -m pip install --quiet -r "${REQUIREMENTS}"`, {
|
|
108
|
+
stdio: "inherit",
|
|
109
|
+
timeout: 120000,
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
fs.writeFileSync(marker, new Date().toISOString());
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
function main() {
|
|
116
|
+
const python = findPython();
|
|
117
|
+
if (!python) {
|
|
118
|
+
process.stderr.write(
|
|
119
|
+
"[arkheia] Error: Python 3.10+ is required but not found.\n" +
|
|
120
|
+
"Install Python from https://python.org and try again.\n"
|
|
121
|
+
);
|
|
122
|
+
process.exit(1);
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// ── Load config from ~/.arkheia/config.json ──────────────────
|
|
126
|
+
const configPath = path.join(
|
|
127
|
+
process.env.HOME || process.env.USERPROFILE || "/tmp",
|
|
128
|
+
".arkheia",
|
|
129
|
+
"config.json"
|
|
130
|
+
);
|
|
131
|
+
let arkheiaConfig = {};
|
|
132
|
+
try {
|
|
133
|
+
if (fs.existsSync(configPath)) {
|
|
134
|
+
arkheiaConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
|
|
135
|
+
process.stderr.write(`[arkheia] Loaded config from ${configPath}\n`);
|
|
136
|
+
}
|
|
137
|
+
} catch (err) {
|
|
138
|
+
process.stderr.write(
|
|
139
|
+
`[arkheia] Warning: Could not read ${configPath}: ${err.message}\n`
|
|
140
|
+
);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
// Inject API key from config if not already in env
|
|
144
|
+
if (!process.env.ARKHEIA_API_KEY && arkheiaConfig.api_key) {
|
|
145
|
+
process.env.ARKHEIA_API_KEY = arkheiaConfig.api_key;
|
|
146
|
+
process.stderr.write("[arkheia] API key loaded from config.json\n");
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
// Inject hosted URL from config if not already in env
|
|
150
|
+
if (!process.env.ARKHEIA_HOSTED_URL && arkheiaConfig.proxy_url) {
|
|
151
|
+
process.env.ARKHEIA_HOSTED_URL = arkheiaConfig.proxy_url;
|
|
152
|
+
process.stderr.write(`[arkheia] Hosted URL: ${arkheiaConfig.proxy_url}\n`);
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
// Check for API key
|
|
156
|
+
if (!process.env.ARKHEIA_API_KEY) {
|
|
157
|
+
process.stderr.write(
|
|
158
|
+
"[arkheia] Warning: ARKHEIA_API_KEY not set.\n" +
|
|
159
|
+
"Get a free API key at https://arkheia.ai/mcp\n" +
|
|
160
|
+
"Then set: export ARKHEIA_API_KEY=ak_live_...\n\n"
|
|
161
|
+
);
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
let venvPython;
|
|
165
|
+
try {
|
|
166
|
+
venvPython = ensureVenv(python);
|
|
167
|
+
installDeps(venvPython);
|
|
168
|
+
} catch (err) {
|
|
169
|
+
process.stderr.write(
|
|
170
|
+
`[arkheia] Error setting up Python environment: ${err.message}\n`
|
|
171
|
+
);
|
|
172
|
+
process.exit(1);
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
// Spawn the MCP server with stdio transport
|
|
176
|
+
const child = spawn(
|
|
177
|
+
venvPython,
|
|
178
|
+
["-m", "mcp_server.server"],
|
|
179
|
+
{
|
|
180
|
+
cwd: PYTHON_DIR,
|
|
181
|
+
stdio: ["pipe", "pipe", "inherit"], // stdin/stdout piped, stderr inherited
|
|
182
|
+
env: {
|
|
183
|
+
...process.env,
|
|
184
|
+
PYTHONPATH: PYTHON_DIR,
|
|
185
|
+
},
|
|
186
|
+
}
|
|
187
|
+
);
|
|
188
|
+
|
|
189
|
+
// Forward stdio for MCP protocol
|
|
190
|
+
process.stdin.pipe(child.stdin);
|
|
191
|
+
child.stdout.pipe(process.stdout);
|
|
192
|
+
|
|
193
|
+
child.on("error", (err) => {
|
|
194
|
+
process.stderr.write(`[arkheia] Failed to start MCP server: ${err.message}\n`);
|
|
195
|
+
process.exit(1);
|
|
196
|
+
});
|
|
197
|
+
|
|
198
|
+
child.on("exit", (code) => {
|
|
199
|
+
process.exit(code || 0);
|
|
200
|
+
});
|
|
201
|
+
|
|
202
|
+
// Forward signals
|
|
203
|
+
process.on("SIGINT", () => child.kill("SIGINT"));
|
|
204
|
+
process.on("SIGTERM", () => child.kill("SIGTERM"));
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
main();
|
package/package.json
CHANGED
|
@@ -1,44 +1,44 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@arkheia/mcp-server",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "1.2.1",
|
|
4
|
+
"mcpName": "io.github.arkheiaai/mcp-server",
|
|
5
|
+
"description": "Arkheia MCP Server — Fabrication detection for LLM outputs. Detect hallucination in any model's output with a single tool call.",
|
|
6
6
|
"bin": {
|
|
7
|
-
"mcp-server": "
|
|
7
|
+
"mcp-server": "bin/arkheia-mcp.js"
|
|
8
8
|
},
|
|
9
9
|
"scripts": {
|
|
10
|
-
"
|
|
11
|
-
"start": "node dist/index.js",
|
|
12
|
-
"prepublishOnly": "npm run build",
|
|
10
|
+
"start": "node bin/arkheia-mcp.js",
|
|
13
11
|
"postinstall": "node scripts/setup.js"
|
|
14
12
|
},
|
|
15
|
-
"files": [
|
|
16
|
-
"dist/",
|
|
17
|
-
"scripts/",
|
|
18
|
-
"README.md",
|
|
19
|
-
"CLAUDE_MD_TEMPLATE.md"
|
|
20
|
-
],
|
|
21
13
|
"keywords": [
|
|
22
14
|
"mcp",
|
|
23
15
|
"ai",
|
|
24
16
|
"fabrication",
|
|
25
|
-
"detection",
|
|
26
17
|
"hallucination",
|
|
27
|
-
"
|
|
18
|
+
"detection",
|
|
19
|
+
"llm",
|
|
20
|
+
"claude",
|
|
21
|
+
"gpt",
|
|
22
|
+
"gemini",
|
|
23
|
+
"governance",
|
|
24
|
+
"audit",
|
|
25
|
+
"grounding",
|
|
26
|
+
"verification"
|
|
28
27
|
],
|
|
29
|
-
"author": "Arkheia AI <
|
|
28
|
+
"author": "Arkheia AI <support@arkheia.ai>",
|
|
30
29
|
"license": "MIT",
|
|
30
|
+
"homepage": "https://arkheia.ai/mcp",
|
|
31
|
+
"repository": {
|
|
32
|
+
"type": "git",
|
|
33
|
+
"url": "git+https://github.com/arkheiaai/arkheia-mcp.git"
|
|
34
|
+
},
|
|
31
35
|
"engines": {
|
|
32
36
|
"node": ">=18.0.0"
|
|
33
37
|
},
|
|
34
|
-
"
|
|
35
|
-
"
|
|
36
|
-
"
|
|
37
|
-
"
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
"@types/sql.js": "^1.4.9",
|
|
41
|
-
"@types/node": "^20.14.10",
|
|
42
|
-
"typescript": "^5.5.3"
|
|
43
|
-
}
|
|
38
|
+
"files": [
|
|
39
|
+
"bin/",
|
|
40
|
+
"scripts/",
|
|
41
|
+
"python/",
|
|
42
|
+
"README.md"
|
|
43
|
+
]
|
|
44
44
|
}
|
|
File without changes
|
package/scripts/build.js
CHANGED
|
@@ -1,33 +1,33 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* Build script — copies Python MCP server source into npm package.
|
|
4
|
-
* Run before `npm publish`.
|
|
5
|
-
*
|
|
6
|
-
* Usage: node scripts/build.js
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
const fs = require("fs");
|
|
10
|
-
const path = require("path");
|
|
11
|
-
|
|
12
|
-
const SRC = path.resolve(__dirname, "..", "..", "mcp_server");
|
|
13
|
-
const DEST = path.resolve(__dirname, "..", "python", "mcp_server");
|
|
14
|
-
|
|
15
|
-
function copyDir(src, dest) {
|
|
16
|
-
if (!fs.existsSync(dest)) {
|
|
17
|
-
fs.mkdirSync(dest, { recursive: true });
|
|
18
|
-
}
|
|
19
|
-
for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
|
|
20
|
-
const srcPath = path.join(src, entry.name);
|
|
21
|
-
const destPath = path.join(dest, entry.name);
|
|
22
|
-
if (entry.name === "__pycache__" || entry.name === "tests") continue;
|
|
23
|
-
if (entry.isDirectory()) {
|
|
24
|
-
copyDir(srcPath, destPath);
|
|
25
|
-
} else if (entry.name.endsWith(".py")) {
|
|
26
|
-
fs.copyFileSync(srcPath, destPath);
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
console.log(`Copying ${SRC} -> ${DEST}`);
|
|
32
|
-
copyDir(SRC, DEST);
|
|
33
|
-
console.log("Build complete. Run `npm publish` from npm-wrapper/.");
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Build script — copies Python MCP server source into npm package.
|
|
4
|
+
* Run before `npm publish`.
|
|
5
|
+
*
|
|
6
|
+
* Usage: node scripts/build.js
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
const fs = require("fs");
|
|
10
|
+
const path = require("path");
|
|
11
|
+
|
|
12
|
+
const SRC = path.resolve(__dirname, "..", "..", "mcp_server");
|
|
13
|
+
const DEST = path.resolve(__dirname, "..", "python", "mcp_server");
|
|
14
|
+
|
|
15
|
+
function copyDir(src, dest) {
|
|
16
|
+
if (!fs.existsSync(dest)) {
|
|
17
|
+
fs.mkdirSync(dest, { recursive: true });
|
|
18
|
+
}
|
|
19
|
+
for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
|
|
20
|
+
const srcPath = path.join(src, entry.name);
|
|
21
|
+
const destPath = path.join(dest, entry.name);
|
|
22
|
+
if (entry.name === "__pycache__" || entry.name === "tests") continue;
|
|
23
|
+
if (entry.isDirectory()) {
|
|
24
|
+
copyDir(srcPath, destPath);
|
|
25
|
+
} else if (entry.name.endsWith(".py")) {
|
|
26
|
+
fs.copyFileSync(srcPath, destPath);
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
console.log(`Copying ${SRC} -> ${DEST}`);
|
|
32
|
+
copyDir(SRC, DEST);
|
|
33
|
+
console.log("Build complete. Run `npm publish` from npm-wrapper/.");
|