aibvf-mcp 0.1.0 → 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 +42 -2
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -10,7 +10,9 @@ npx aibvf-mcp
|
|
|
10
10
|
|
|
11
11
|
## Wire into Claude Desktop / Cursor / any MCP host
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
### macOS and Linux
|
|
14
|
+
|
|
15
|
+
Add to your MCP config (on Claude Desktop macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):
|
|
14
16
|
|
|
15
17
|
```json
|
|
16
18
|
{
|
|
@@ -23,12 +25,50 @@ Add to your MCP config:
|
|
|
23
25
|
}
|
|
24
26
|
```
|
|
25
27
|
|
|
26
|
-
|
|
28
|
+
### Windows
|
|
29
|
+
|
|
30
|
+
Windows needs `cmd /c` because `npx` on Windows is `npx.cmd` and Claude Desktop's process spawner doesn't auto-resolve the `.cmd` extension. Use this config in `%APPDATA%\Claude\claude_desktop_config.json`:
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"mcpServers": {
|
|
35
|
+
"aibvf": {
|
|
36
|
+
"command": "cmd",
|
|
37
|
+
"args": ["/c", "npx", "-y", "aibvf-mcp"]
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
If that still fails, use the full path to `npx.cmd`. Find it with `where npx` in a terminal; it's usually `C:\Program Files\nodejs\npx.cmd`. Then:
|
|
44
|
+
|
|
45
|
+
```json
|
|
46
|
+
{
|
|
47
|
+
"mcpServers": {
|
|
48
|
+
"aibvf": {
|
|
49
|
+
"command": "C:\\Program Files\\nodejs\\npx.cmd",
|
|
50
|
+
"args": ["-y", "aibvf-mcp"]
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
(Double backslashes are required inside JSON strings.)
|
|
57
|
+
|
|
58
|
+
### After configuring
|
|
59
|
+
|
|
60
|
+
Fully quit and restart the host (on Windows, right-click the Claude tray icon → Quit; closing the window leaves it running). Then ask Claude:
|
|
27
61
|
|
|
28
62
|
> *"Score this AI initiative using AI BVF: we're a €2.4bn manufacturer, planning a GenAI predictive maintenance rollout in our EU plants, we're a traditional hierarchy, strong sponsor, modest change budget."*
|
|
29
63
|
|
|
30
64
|
Claude will call `score_initiative` and return the classification, euro range, and reasoning.
|
|
31
65
|
|
|
66
|
+
## Troubleshooting
|
|
67
|
+
|
|
68
|
+
- **No tools icon appears after restart.** The config JSON probably has a syntax error. Validate with `python -m json.tool <path-to-config>`.
|
|
69
|
+
- **"Could not attach to MCP server aibvf."** Open the host's MCP log (on Claude Desktop Windows: `%APPDATA%\Claude\logs\mcp-server-aibvf.log`) for the actual error. Most common cause on Windows is the `npx` / `cmd /c` spawning issue above.
|
|
70
|
+
- **Tools show but calls fail.** Your npx cache may have a broken copy; clear it with `npx clear-npx-cache` and retry.
|
|
71
|
+
|
|
32
72
|
## Tools exposed
|
|
33
73
|
|
|
34
74
|
| Tool | Purpose |
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "aibvf-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "MCP server exposing AI BVF v1.0 scoring and validation to any Claude agent.",
|
|
5
5
|
"keywords": ["mcp", "model-context-protocol", "ai-bvf", "claude", "agent", "ai-governance"],
|
|
6
6
|
"homepage": "https://bvf-app.vercel.app/protocol",
|
|
7
|
-
"repository": "github:
|
|
7
|
+
"repository": "github:Bahamas1717/ai-bvf",
|
|
8
8
|
"license": "MIT",
|
|
9
9
|
"author": "Craig Horton",
|
|
10
10
|
"type": "module",
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"start": "node dist/index.js"
|
|
19
19
|
},
|
|
20
20
|
"dependencies": {
|
|
21
|
-
"@aibvf/core": "^0.1.
|
|
21
|
+
"@aibvf/core": "^0.1.1",
|
|
22
22
|
"@modelcontextprotocol/sdk": "^1.0.0"
|
|
23
23
|
},
|
|
24
24
|
"devDependencies": {
|