@odingard/guardian-mcp 0.0.0-stage → 0.1.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 +41 -2
- package/dist/index.js +17204 -0
- package/package.json +36 -4
- package/server.json +43 -0
package/README.md
CHANGED
|
@@ -1,3 +1,42 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @odingard/guardian-mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
MCP server that routes an agent's tool calls through [Guardian](https://github.com/Odingard/guardian-sdk) — the human authority layer for autonomous AI. Every tool call gets a deterministic **ALLOW / ASK / DENY** decision before anything executes; DENY means the action never runs, and ASK holds it until a human approves.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm i -g @odingard/guardian-mcp
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Configure your MCP client
|
|
12
|
+
|
|
13
|
+
```json
|
|
14
|
+
{
|
|
15
|
+
"mcpServers": {
|
|
16
|
+
"guardian": {
|
|
17
|
+
"command": "guardian-mcp",
|
|
18
|
+
"env": {
|
|
19
|
+
"GUARDIAN_BASE_URL": "https://api.guardian.odingard.com",
|
|
20
|
+
"GUARDIAN_AGENT_CREDENTIAL": "gac1.…",
|
|
21
|
+
"GUARDIAN_CONNECTION_ID": "con_…"
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
`GUARDIAN_ADAPTER_ID` optionally overrides the tool adapter.
|
|
29
|
+
|
|
30
|
+
## Tools
|
|
31
|
+
|
|
32
|
+
| Tool | What it does |
|
|
33
|
+
| --- | --- |
|
|
34
|
+
| `guardian_invoke_tool` | Propose a tool call. ALLOW executes and returns the receipt; ASK returns a `requestId` held for human approval; DENY refuses with a reason code. |
|
|
35
|
+
| `guardian_claim` | Claim an approved ASK by `requestId`, execute, return the receipt. |
|
|
36
|
+
| `guardian_receipt` | Fetch the machine-readable evidence receipts for a request. |
|
|
37
|
+
|
|
38
|
+
Nothing executes without a Guardian capability — the model's output is a proposal, never an action.
|
|
39
|
+
|
|
40
|
+
## License
|
|
41
|
+
|
|
42
|
+
Apache-2.0. Canonical development happens in the Odingard Guardian monorepo.
|