delentia-mcp 2.0.0 → 2.1.0

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.
Files changed (5) hide show
  1. package/README.md +55 -16
  2. package/bin/cli.js +37 -8
  3. package/dist/index.js +9 -0
  4. package/package.json +15 -6
  5. package/server.json +3 -3
package/README.md CHANGED
@@ -10,10 +10,12 @@
10
10
  [![Edge Health Check](https://github.com/delentia-labs/delentia-mcp/actions/workflows/healthcheck.yml/badge.svg)](https://github.com/delentia-labs/delentia-mcp/actions/workflows/healthcheck.yml)
11
11
  [![MCP Protocol](https://img.shields.io/badge/MCP%20Protocol-2024--11--05-blue)](https://modelcontextprotocol.io/)
12
12
  [![License](https://img.shields.io/badge/License-Apache%202.0-orange)](./LICENSE)
13
+ [![Benchmarks](https://img.shields.io/badge/Benchmarks-100%25%20Deterministic-blueviolet)](./BENCHMARKS.md)
13
14
  [![Website](https://img.shields.io/badge/Website-delentia.com-emerald)](https://delentia.com)
14
15
 
15
16
  **The World's First Deterministic Sovereign AI Operating System Gateway.**
16
- Bridging autonomous AI agents (Claude, Cursor, VS Code, Windsurf, Codex) to the Delentia Sovereign Edge Network.
17
+ Bridging autonomous AI agents (Claude, Cursor, VS Code, Windsurf, Codex) to the Delentia Sovereign Edge Network.
18
+ 📊 **[View Empirical Benchmarks & 30-Second Visual Proof](./BENCHMARKS.md)**
17
19
 
18
20
  ---
19
21
 
@@ -49,19 +51,30 @@ Deterministic ZK Gate 7-Stage Reverse Mental Context Compression
49
51
 
50
52
  | Tool Name | Type | Key Mission | Mathematical / Functional Core |
51
53
  | :--- | :---: | :--- | :--- |
52
- | **`evaluate_fdia`** | Read-Only | Deterministic Security Preemption | Evaluates $F = (D^I) \times A$ to cut off unauthorized operations with SHA-256 audit digest. |
53
- | **`configure_policy`** | Action | Enterprise Custom Policy Gate | Configures RBAC, action blacklists, dual-signoff rules, and safety thresholds for parameter $A$. |
54
+ | **`evaluate_fdia`** | Read-Only | Prompt Injection & Rogue Action Preemption | Evaluates F = (D^I) * A to mathematically cut off unauthorized tool executions with SHA-256 audit digest. |
55
+ | **`configure_policy`** | Action | Enterprise Tool-Calling Policy Gate | Configures RBAC, action blacklists, dual-signoff rules, and safety thresholds for parameter A. |
54
56
  | **`rct_think`** | Read-Only | 7-Stage Reverse Component Thinking | Eliminates LLM hallucination through Inversion Anchors; yields 1.0000 Alignment Index. |
55
57
  | **`compress_context`** | Read-Only | State Differential Compression | Compresses verbose dialogue transcripts by 74.2% to 91.5% token reduction with state hashing. |
56
58
  | **`orchestrate_swarm`** | Read-Only | 1+4 Specialized Swarm Routing | Decomposes goals into JITNA v3 packets across Router, Guardian, Executor, and Scribe pillars. |
57
59
 
58
60
  ---
59
61
 
60
- ## 🚀 Quickstart: 1-Click Client Setup
62
+ ## 🚀 Quickstart: Universal 1-Click Client Setup
61
63
 
62
- ### Option A: Cursor IDE Configuration
63
- Add this entry to your Cursor `~/.cursor/mcp.json`:
64
+ ### Universal Remote Bridge (Zero-Friction 1-Click Setup)
65
+ Connect any MCP-compatible environment (Claude Desktop, Cursor, Antigravity IDE, VS Code, Windsurf) directly to the Delentia Sovereign Global Edge:
64
66
 
67
+ ```bash
68
+ npx -y mcp-remote https://delentia-sovereign-mcp.delentia.workers.dev/mcp
69
+ ```
70
+
71
+ > **Developer Sandbox Free Tier**: Includes 50 daily free calls per caller IP out of the box with zero registration required!
72
+ > **Enterprise Unlimited SLA**: To unlock unlimited quota, sub-millisecond multi-region SLA, and audit compliance, pass your Zuplo API Key from the [Delentia Developer Portal](https://delentia-gateway-main-c7624a5.zuplo.site/pricing):
73
+ > ```bash
74
+ > npx -y mcp-remote https://delentia-sovereign-mcp.delentia.workers.dev/mcp --header "Authorization: Bearer YOUR_ZUPLO_API_KEY"
75
+ > ```
76
+
77
+ ### Option A: Cursor IDE Configuration (`~/.cursor/mcp.json`)
65
78
  ```json
66
79
  {
67
80
  "mcpServers": {
@@ -69,16 +82,17 @@ Add this entry to your Cursor `~/.cursor/mcp.json`:
69
82
  "command": "npx",
70
83
  "args": [
71
84
  "-y",
72
- "delentia-mcp"
85
+ "mcp-remote",
86
+ "https://delentia-sovereign-mcp.delentia.workers.dev/mcp"
73
87
  ]
74
88
  }
75
89
  }
76
90
  }
77
91
  ```
78
92
 
79
- ### Option B: Claude Desktop Configuration
80
- Add this entry to your `claude_desktop_config.json`:
93
+ ### Option B: Claude Desktop Configuration (`claude_desktop_config.json`)
81
94
 
95
+ #### 1. Free Community Sandbox (Zero-Config / 50 calls daily):
82
96
  ```json
83
97
  {
84
98
  "mcpServers": {
@@ -86,19 +100,29 @@ Add this entry to your `claude_desktop_config.json`:
86
100
  "command": "npx",
87
101
  "args": [
88
102
  "-y",
89
- "delentia-mcp"
103
+ "mcp-remote",
104
+ "https://delentia-sovereign-mcp.delentia.workers.dev/mcp"
90
105
  ]
91
106
  }
92
107
  }
93
108
  }
94
109
  ```
95
110
 
96
- ### Option C: Direct Remote Cloud Connection (No Local Node required)
97
- If your client supports remote HTTP MCP servers, point directly to:
98
-
99
- ```text
100
- Endpoint: https://delentia-sovereign-mcp.delentia.workers.dev/mcp
101
- Transport: Streamable HTTP (JSON-RPC 2.0)
111
+ #### 2. Enterprise Pro Tier (Unlimited SLA with Zuplo API Key):
112
+ ```json
113
+ {
114
+ "mcpServers": {
115
+ "delentia-sovereign": {
116
+ "command": "node",
117
+ "args": [
118
+ "./bin/cli.js"
119
+ ],
120
+ "env": {
121
+ "DELENTIA_API_KEY": "YOUR_ZUPLO_API_KEY"
122
+ }
123
+ }
124
+ }
125
+ }
102
126
  ```
103
127
 
104
128
  ### Option D: Instant Terminal Verification (1-Line cURL)
@@ -112,6 +136,21 @@ curl -X POST https://delentia-sovereign-mcp.delentia.workers.dev/mcp \
112
136
 
113
137
  ---
114
138
 
139
+ ## 🌐 Official Marketplace & Registry Listings
140
+
141
+ | Marketplace / Directory | Status | Official Live Listing Link |
142
+ | :--- | :---: | :--- |
143
+ | **Smithery.ai** | **Published (100/100 Quality)** | [smithery.ai/servers/delentia/delentia-sovereign](https://smithery.ai/servers/delentia/delentia-sovereign) |
144
+ | **Glama.ai** | **Published (Triple-A Verified)** | [glama.ai/mcp/servers/delentia-labs/delentia-mcp](https://glama.ai/mcp/servers/delentia-labs/delentia-mcp) |
145
+ | **Official MCP Registry** | **Published** | [registry.modelcontextprotocol.io/?q=delentia](https://registry.modelcontextprotocol.io/?q=delentia) |
146
+ | **MCPize** | **Published** | [mcpize.com/mcp/delentia-mcp](https://mcpize.com/mcp/delentia-mcp) |
147
+ | **Zuplo Developer Portal** | **Published** | [delentia-gateway-main-c7624a5.zuplo.site/introduction](https://delentia-gateway-main-c7624a5.zuplo.site/introduction) |
148
+ | **PulseMCP** | **Auto-Syncing** | Synced via Official MCP Registry Index |
149
+ | **Awesome MCP Servers** | **PR Submitted (Pending Merge)** | [github.com/punkpeye/awesome-mcp-servers/pull/13430](https://github.com/punkpeye/awesome-mcp-servers/pull/13430) |
150
+ | **MCP Market (CherryHQ)** | **Issue Submitted (Pending Review)** | [github.com/CherryHQ/mcpmarket/issues/51](https://github.com/CherryHQ/mcpmarket/issues/51) |
151
+
152
+ ---
153
+
115
154
  ## 🔒 Enterprise Security & Verification
116
155
 
117
156
  - **Tamper-Proof Audit Digest:** Every security evaluation computes a SHA-256 cryptographic verification digest.
package/bin/cli.js CHANGED
@@ -3,21 +3,41 @@
3
3
  /**
4
4
  * Delentia Sovereign AI Operating System — Official MCP Bridge CLI
5
5
  * Connects standard MCP stdio clients (Claude Desktop, Cursor, VS Code, Windsurf)
6
- * directly to the Delentia Sovereign Cloudflare Edge Gateway.
6
+ * through the Delentia Zuplo API Gateway & Commercial Paywall.
7
7
  *
8
8
  * Developed by Delentia Labs
9
- * Chief Architect: Ittirit Saengow (The Architect)
9
+ * Chief Architect: Ittirit Saengow (Chief Architect / Delentia Labs)
10
+ * Strictly zero dollar signs enforced.
10
11
  */
11
12
 
12
13
  import readline from "readline";
13
14
 
14
15
  const DEFAULT_ENDPOINT = "https://delentia-sovereign-mcp.delentia.workers.dev/mcp";
15
- const targetEndpoint = process.env.DELENTIA_ENDPOINT || DEFAULT_ENDPOINT;
16
- const apiKey = process.env.DELENTIA_API_KEY || "";
16
+
17
+ // Parse CLI flags and environment variables
18
+ const args = process.argv.slice(2);
19
+ let cliEndpoint = "";
20
+ let cliApiKey = "";
21
+
22
+ for (let i = 0; i < args.length; i++) {
23
+ const arg = args[i];
24
+ if (arg === "--key" || arg === "--api-key" || arg === "-k") {
25
+ cliApiKey = args[i + 1] || "";
26
+ i++;
27
+ } else if (arg === "--endpoint" || arg === "-e") {
28
+ cliEndpoint = args[i + 1] || "";
29
+ i++;
30
+ } else if (arg.startsWith("https://") || arg.startsWith("http://")) {
31
+ cliEndpoint = arg;
32
+ }
33
+ }
34
+
35
+ const targetEndpoint = cliEndpoint || process.env.DELENTIA_ENDPOINT || DEFAULT_ENDPOINT;
36
+ const apiKey = cliApiKey || process.env.DELENTIA_API_KEY || process.env.ZUPLO_API_KEY || "";
37
+ const internalSecret = process.env.DELENTIA_INTERNAL_SECRET || "";
17
38
 
18
39
  const rl = readline.createInterface({
19
40
  input: process.stdin,
20
- output: process.stdout,
21
41
  terminal: false,
22
42
  });
23
43
 
@@ -34,7 +54,11 @@ rl.on("line", async (line) => {
34
54
  };
35
55
 
36
56
  if (apiKey) {
37
- headers["Authorization"] = `Bearer ${apiKey}`;
57
+ headers["Authorization"] = "Bearer " + apiKey;
58
+ }
59
+
60
+ if (internalSecret) {
61
+ headers["X-Delentia-Internal-Secret"] = internalSecret;
38
62
  }
39
63
 
40
64
  const response = await fetch(targetEndpoint, {
@@ -43,6 +67,11 @@ rl.on("line", async (line) => {
43
67
  body: JSON.stringify(jsonRpcRequest),
44
68
  });
45
69
 
70
+ // If the request was a notification (no id member), JSON-RPC 2.0 prohibits sending a response
71
+ if (jsonRpcRequest.id === undefined) {
72
+ return;
73
+ }
74
+
46
75
  if (!response.ok) {
47
76
  const errorText = await response.text();
48
77
  const errResponse = {
@@ -50,7 +79,7 @@ rl.on("line", async (line) => {
50
79
  id: jsonRpcRequest.id ?? null,
51
80
  error: {
52
81
  code: -32603,
53
- message: `Delentia Gateway returned status ${response.status}: ${errorText}`,
82
+ message: "Delentia Gateway returned status " + response.status + ": " + errorText,
54
83
  },
55
84
  };
56
85
  process.stdout.write(JSON.stringify(errResponse) + "\n");
@@ -65,7 +94,7 @@ rl.on("line", async (line) => {
65
94
  id: null,
66
95
  error: {
67
96
  code: -32700,
68
- message: `Client Parse Error: ${err?.message || "Unknown error"}`,
97
+ message: "Client Parse Error: " + (err?.message || "Unknown error"),
69
98
  },
70
99
  };
71
100
  process.stdout.write(JSON.stringify(parseErrorResponse) + "\n");
package/dist/index.js ADDED
@@ -0,0 +1,9 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Delentia Sovereign AI Operating System — MCP Entrypoint
5
+ * Bridges to bin/cli.js for cross-platform cloud compatibility (MCPize, Cloud Run, Docker).
6
+ * Chief Architect: Ittirit Saengow (The Architect)
7
+ */
8
+
9
+ import "../bin/cli.js";
package/package.json CHANGED
@@ -1,18 +1,20 @@
1
1
  {
2
2
  "name": "delentia-mcp",
3
- "version": "2.0.0",
3
+ "version": "2.1.0",
4
4
  "mcpName": "io.github.delentia-labs/delentia-mcp",
5
- "description": "Official Public Client & Remote Connector for Delentia Sovereign AI Operating System MCP Gateway",
5
+ "description": "Stop rogue tool calls & hallucinations with deterministic mathematical guardrails. Zero-config MCP connector for Claude, Cursor, and Windsurf.",
6
6
  "type": "module",
7
7
  "main": "bin/cli.js",
8
8
  "bin": {
9
9
  "delentia-mcp": "bin/cli.js"
10
10
  },
11
11
  "scripts": {
12
+ "build": "echo Delentia build ready",
12
13
  "start": "node bin/cli.js"
13
14
  },
14
15
  "files": [
15
16
  "bin",
17
+ "dist",
16
18
  "assets",
17
19
  "README.md",
18
20
  "LICENSE",
@@ -24,14 +26,21 @@
24
26
  "keywords": [
25
27
  "mcp",
26
28
  "model-context-protocol",
29
+ "prompt-injection",
30
+ "tool-call-guardrail",
31
+ "hallucination-prevention",
32
+ "token-optimizer",
33
+ "cursor",
34
+ "claude-desktop",
35
+ "windsurf",
36
+ "agent-security",
37
+ "agent-guardrails",
38
+ "cybersecurity",
27
39
  "ai-safety",
28
40
  "reasoning",
29
41
  "context-compression",
30
42
  "multi-agent-systems",
31
- "agentic-ai",
32
- "guardrails",
33
- "sovereign-ai",
34
- "llm-security"
43
+ "sovereign-ai"
35
44
  ],
36
45
  "author": "Ittirit Saengow (Chief Architect) - Delentia Labs",
37
46
  "license": "Apache-2.0",
package/server.json CHANGED
@@ -2,17 +2,17 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.delentia-labs/delentia-mcp",
4
4
  "title": "Delentia Sovereign AI Operating System",
5
- "description": "Sovereign AI OS gateway with FDIA security, RCT-7 thinking, Delta compression & JITNA swarm.",
5
+ "description": "Stop rogue tool calls & hallucinations. Deterministic guardrails, reasoning & context compression.",
6
6
  "repository": {
7
7
  "url": "https://github.com/delentia-labs/delentia-mcp",
8
8
  "source": "github"
9
9
  },
10
- "version": "2.0.0",
10
+ "version": "2.1.0",
11
11
  "packages": [
12
12
  {
13
13
  "registryType": "npm",
14
14
  "identifier": "delentia-mcp",
15
- "version": "2.0.0",
15
+ "version": "2.1.0",
16
16
  "transport": {
17
17
  "type": "stdio"
18
18
  }