@spilno/herald-mcp 1.1.2 → 1.1.3
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 +53 -10
- package/package.json +4 -2
package/README.md
CHANGED
|
@@ -1,16 +1,14 @@
|
|
|
1
1
|
# @spilno/herald-mcp
|
|
2
2
|
|
|
3
|
-
Herald MCP -
|
|
3
|
+
Herald MCP - AI-native interface to [CEDA](https://getceda.com) (Cognitive Event-Driven Architecture).
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
+
# Run directly (no install)
|
|
8
9
|
npx @spilno/herald-mcp
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
Or install globally:
|
|
12
10
|
|
|
13
|
-
|
|
11
|
+
# Or install globally
|
|
14
12
|
npm install -g @spilno/herald-mcp
|
|
15
13
|
herald-mcp
|
|
16
14
|
```
|
|
@@ -23,15 +21,39 @@ Set environment variables:
|
|
|
23
21
|
|----------|----------|-------------|
|
|
24
22
|
| `HERALD_API_URL` | Yes | CEDA server URL (e.g., `https://getceda.com`) |
|
|
25
23
|
| `HERALD_API_TOKEN` | No | Bearer token for authentication |
|
|
24
|
+
| `HERALD_API_USER` | No | Basic auth username (alternative to token) |
|
|
25
|
+
| `HERALD_API_PASS` | No | Basic auth password (alternative to token) |
|
|
26
26
|
|
|
27
27
|
## Tools
|
|
28
28
|
|
|
29
|
-
Herald exposes
|
|
29
|
+
Herald exposes 6 MCP tools:
|
|
30
|
+
|
|
31
|
+
| Tool | Description |
|
|
32
|
+
|------|-------------|
|
|
33
|
+
| `herald_health` | Check CEDA system status |
|
|
34
|
+
| `herald_stats` | Get server statistics and loaded patterns |
|
|
35
|
+
| `herald_predict` | Generate prediction from natural language input |
|
|
36
|
+
| `herald_refine` | Refine existing prediction with additional requirements |
|
|
37
|
+
| `herald_session` | Get session history and state |
|
|
38
|
+
| `herald_observe` | Record prediction feedback for learning |
|
|
30
39
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
40
|
+
## Usage with Claude Code
|
|
41
|
+
|
|
42
|
+
Add to `~/.claude.json`:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"mcpServers": {
|
|
47
|
+
"herald": {
|
|
48
|
+
"command": "npx",
|
|
49
|
+
"args": ["@spilno/herald-mcp"],
|
|
50
|
+
"env": {
|
|
51
|
+
"HERALD_API_URL": "https://getceda.com"
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
35
57
|
|
|
36
58
|
## Usage with Claude Desktop
|
|
37
59
|
|
|
@@ -60,6 +82,27 @@ In Devin MCP marketplace:
|
|
|
60
82
|
- **Arguments**: `@spilno/herald-mcp`
|
|
61
83
|
- **Environment**: `HERALD_API_URL=https://getceda.com`
|
|
62
84
|
|
|
85
|
+
## Multi-turn Conversations
|
|
86
|
+
|
|
87
|
+
Herald supports session-based conversations for iterative refinement:
|
|
88
|
+
|
|
89
|
+
```
|
|
90
|
+
1. herald_predict("create assessment module")
|
|
91
|
+
→ Returns sessionId + initial prediction
|
|
92
|
+
|
|
93
|
+
2. herald_refine(sessionId, "add OSHA compliance fields")
|
|
94
|
+
→ Returns refined prediction
|
|
95
|
+
|
|
96
|
+
3. herald_refine(sessionId, "include corrective actions workflow")
|
|
97
|
+
→ Returns further refined prediction
|
|
98
|
+
|
|
99
|
+
4. herald_session(sessionId)
|
|
100
|
+
→ Returns full history of all turns
|
|
101
|
+
|
|
102
|
+
5. herald_observe(sessionId, accepted=true)
|
|
103
|
+
→ Records feedback for learning
|
|
104
|
+
```
|
|
105
|
+
|
|
63
106
|
## License
|
|
64
107
|
|
|
65
108
|
MIT
|
package/package.json
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@spilno/herald-mcp",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.3",
|
|
4
4
|
"description": "Herald MCP - AI-native interface to CEDA (Cognitive Event-Driven Architecture)",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
7
|
-
"bin":
|
|
7
|
+
"bin": {
|
|
8
|
+
"herald-mcp": "./dist/index.js"
|
|
9
|
+
},
|
|
8
10
|
"scripts": {
|
|
9
11
|
"build": "tsc",
|
|
10
12
|
"start": "node dist/index.js",
|