@aborruso/ckan-mcp-server 0.3.1 → 0.3.2
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/.claude/settings.local.json +2 -1
- package/LOG.md +11 -0
- package/README.md +51 -5
- package/package.json +4 -1
package/LOG.md
CHANGED
|
@@ -2,6 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
## 2026-01-09
|
|
4
4
|
|
|
5
|
+
### NPM Global Installation Support
|
|
6
|
+
- **package.json**: Added `bin` field for global command support
|
|
7
|
+
- Users can now install globally: `npm install -g @aborruso/ckan-mcp-server`
|
|
8
|
+
- Direct command: `ckan-mcp-server` (no need for node path)
|
|
9
|
+
- **README.md**: Enhanced Claude Desktop configuration section
|
|
10
|
+
- Option 1: Global installation (recommended) - single command
|
|
11
|
+
- Option 2: Local installation - project-specific
|
|
12
|
+
- Option 3: From source - development
|
|
13
|
+
- Clear path instructions for all platforms (macOS, Windows, Linux)
|
|
14
|
+
- **Impact**: Simplified setup for end users, better npm ecosystem integration
|
|
15
|
+
|
|
5
16
|
### README Enhancement - Real-World Advanced Examples
|
|
6
17
|
- **New Section**: "Advanced Query Examples" in README.md
|
|
7
18
|
- 4 real-world examples tested on dati.gov.it portal
|
package/README.md
CHANGED
|
@@ -56,22 +56,68 @@ The server will be available at `http://localhost:3000/mcp`
|
|
|
56
56
|
|
|
57
57
|
## Claude Desktop Configuration
|
|
58
58
|
|
|
59
|
-
|
|
59
|
+
Configuration file location:
|
|
60
|
+
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
61
|
+
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
62
|
+
- **Linux**: `~/.config/Claude/claude_desktop_config.json`
|
|
63
|
+
|
|
64
|
+
### Option 1: Global Installation (Recommended)
|
|
65
|
+
|
|
66
|
+
Install globally to use across all projects:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npm install -g @aborruso/ckan-mcp-server
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Then add to `claude_desktop_config.json`:
|
|
73
|
+
|
|
74
|
+
```json
|
|
75
|
+
{
|
|
76
|
+
"mcpServers": {
|
|
77
|
+
"ckan": {
|
|
78
|
+
"command": "ckan-mcp-server"
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Option 2: Local Installation
|
|
85
|
+
|
|
86
|
+
Install in a specific project:
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
npm install @aborruso/ckan-mcp-server
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Then add to `claude_desktop_config.json`:
|
|
60
93
|
|
|
61
94
|
```json
|
|
62
95
|
{
|
|
63
96
|
"mcpServers": {
|
|
64
97
|
"ckan": {
|
|
65
98
|
"command": "node",
|
|
66
|
-
"args": ["/path/to/ckan-mcp-server/dist/index.js"]
|
|
99
|
+
"args": ["/absolute/path/to/project/node_modules/@aborruso/ckan-mcp-server/dist/index.js"]
|
|
67
100
|
}
|
|
68
101
|
}
|
|
69
102
|
}
|
|
70
103
|
```
|
|
71
104
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
105
|
+
Replace `/absolute/path/to/project` with your actual project path.
|
|
106
|
+
|
|
107
|
+
### Option 3: From Source
|
|
108
|
+
|
|
109
|
+
If you cloned the repository:
|
|
110
|
+
|
|
111
|
+
```json
|
|
112
|
+
{
|
|
113
|
+
"mcpServers": {
|
|
114
|
+
"ckan": {
|
|
115
|
+
"command": "node",
|
|
116
|
+
"args": ["/absolute/path/to/ckan-mcp-server/dist/index.js"]
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
```
|
|
75
121
|
|
|
76
122
|
## Available Tools
|
|
77
123
|
|
package/package.json
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aborruso/ckan-mcp-server",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"description": "MCP server for interacting with CKAN open data portals",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"ckan-mcp-server": "dist/index.js"
|
|
9
|
+
},
|
|
7
10
|
"scripts": {
|
|
8
11
|
"build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:@modelcontextprotocol/sdk --external:axios --external:express --external:zod",
|
|
9
12
|
"build:tsc": "node --max-old-space-size=8192 ./node_modules/typescript/bin/tsc",
|