@aborruso/ckan-mcp-server 0.4.2 → 0.4.4

package/EXAMPLES.md

@@ -210,6 +210,14 @@ ckan_datastore_search({
 })
 ```
 
+### SQL query
+```typescript
+ckan_datastore_search_sql({
+  server_url: "https://demo.ckan.org",
+  sql: "SELECT Country, COUNT(*) AS total FROM \"5b3cf3a8-9a58-45ee-8e1a-4d98b8320c9a\" GROUP BY Country ORDER BY total DESC LIMIT 10"
+})
+```
+
 ## Advanced Solr Searches
 
 ### AND combination
@@ -285,6 +293,25 @@ ckan_package_search({
 })
 ```
 
+## Tags and Groups
+
+### List groups
+```typescript
+ckan_group_list({
+  server_url: "https://www.dati.gov.it/opendata",
+  all_fields: true,
+  limit: 20
+})
+```
+
+### Show group details
+```typescript
+ckan_group_show({
+  server_url: "https://www.dati.gov.it/opendata",
+  id: "ambiente"
+})
+```
+
 ## Advanced Solr Query Features
 
 CKAN uses Apache Solr for search. The `q` parameter supports advanced Solr query syntax including fuzzy matching, proximity search, boosting, and complex boolean logic.

package/LOG.md

@@ -2,6 +2,19 @@
 
 ## 2026-01-10
 
+### Version 0.4.4 - DataStore SQL
+- **Tool**: Added `ckan_datastore_search_sql`
+- **Docs**: Updated README/EXAMPLES/PRD for SQL support
+- **Tests**: Added SQL fixture and checks
+
+## 2026-01-10
+
+### Version 0.4.3 - Tags and Groups
+- **Tags**: Added `ckan_tag_list` with faceting and filtering
+- **Groups**: Added `ckan_group_list`, `ckan_group_show`, `ckan_group_search`
+- **Docs**: Updated README with examples and tool list
+- **Tests**: Added tag/group fixtures and tests
+
 ### Version 0.4.2 - Packaging
 - **npm package**: Added `.npmignore` to exclude dev artifacts
 

package/PRD.md

@@ -653,9 +653,9 @@ ckan_package_search({
    - Max 32.000 record per query
    - Dipende dalla configurazione del server CKAN
 
-5. **No SQL Support**:
-   - Tool `ckan_datastore_search_sql` menzionato come "in sviluppo"
-   - Non implementato nel codice attuale
+5. **SQL Support Limitations**:
+   - `ckan_datastore_search_sql` funziona solo se il portale espone l'endpoint SQL
+   - Alcuni portali disabilitano SQL per motivi di sicurezza
 
 6. **Timeout**:
    - 30 secondi fissi per HTTP request
@@ -696,9 +696,9 @@ ckan_package_search({
   - API key per endpoint privati
   - OAuth per portali che lo supportano
   
-- [ ] **SQL Query Support**
-  - Implementare `ckan_datastore_search_sql`
-  - Supporto query SQL complete
+- [x] **SQL Query Support**
+  - Implementato `ckan_datastore_search_sql`
+  - Richiede portali con DataStore SQL attivo
 
 - [ ] **Caching Layer**
   - Cache risultati frequenti

package/README.md

@@ -1,5 +1,7 @@
 # CKAN MCP Server
 
+[![npm version](https://img.shields.io/npm/v/@aborruso/ckan-mcp-server)](https://www.npmjs.com/package/@aborruso/ckan-mcp-server)
+
 MCP (Model Context Protocol) server for interacting with CKAN-based open data portals.
 
 ## Features
@@ -12,14 +14,14 @@ MCP (Model Context Protocol) server for interacting with CKAN-based open data po
 - 🎨 Output in Markdown or JSON format
 - ⚡ Pagination and faceting support
 - 📄 MCP Resource Templates for direct data access
-- 🧪 Comprehensive test suite (113 tests, 100% passing)
+- 🧪 Comprehensive test suite (120 tests, 100% passing)
 
 ## Installation
 
 ### From npm (recommended)
 
 ```bash
-npm install ckan-mcp-server
+npm install -g @aborruso/ckan-mcp-server
 ```
 
 ### From source
@@ -34,7 +36,7 @@ npm install
 # Build with esbuild (fast, ~4ms)
 npm run build
 
-# Run tests (113 tests)
+# Run tests (120 tests)
 npm test
 ```
 
@@ -76,38 +78,19 @@ TRANSPORT=http PORT=3000 npm start
 
 **Best for**: Global access, zero infrastructure, free hosting
 
-Deploy to Cloudflare's edge network for worldwide low-latency access.
-
-**Prerequisites**:
-- Cloudflare account (free): https://dash.cloudflare.com/sign-up
-- Wrangler CLI: `npm install -g wrangler`
-
-**Quick Deploy**:
-
-```bash
-# Clone repository
-git clone https://github.com/aborruso/ckan-mcp-server.git
-cd ckan-mcp-server
-
-# Install dependencies
-npm install
-
-# Authenticate with Cloudflare
-wrangler login
+Use the public Workers endpoint (no local install required):
 
-# Deploy to Workers
-npm run deploy
+```json
+{
+  "mcpServers": {
+    "ckan": {
+      "url": "https://ckan-mcp-server.andy-pr.workers.dev/mcp"
+    }
+  }
+}
 ```
 
-Your server will be live at: `https://ckan-mcp-server.<your-account>.workers.dev`
-
-**Free tier includes**:
-- 100,000 requests/day
-- Global edge deployment
-- Automatic HTTPS
-- No cold starts
-
-For detailed deployment instructions, see [DEPLOYMENT.md](docs/DEPLOYMENT.md).
+Want your own deployment? See [DEPLOYMENT.md](docs/DEPLOYMENT.md).
 
 ## Claude Desktop Configuration
 
@@ -137,22 +120,16 @@ Then add to `claude_desktop_config.json`:
 }
 ```
 
-### Option 2: Local Installation
+### Option 2: Local Installation (Optional)
 
-Install in a specific project:
-
-```bash
-npm install @aborruso/ckan-mcp-server
-```
-
-Then add to `claude_desktop_config.json`:
+If you installed locally (see Installation), use this config:
 
 ```json
 {
   "mcpServers": {
     "ckan": {
       "command": "node",
-      "args": ["/absolute/path/to/project/node_modules/@aborruso/ckan-mcp-server/dist/index.js"]
+      "args": ["/absolute/path/to/project/node_modules/@username/ckan-mcp-server/dist/index.js"]
     }
   }
 }
@@ -198,6 +175,7 @@ Use the public Cloudflare Workers deployment (no local installation required):
 - **ckan_package_search**: Search datasets with Solr queries
 - **ckan_package_show**: Complete details of a dataset
 - **ckan_package_list**: List all datasets
+- **ckan_tag_list**: List tags with counts
 
 ### Organizations
 
@@ -207,7 +185,13 @@ Use the public Cloudflare Workers deployment (no local installation required):
 ### DataStore
 
 - **ckan_datastore_search**: Query tabular data
-- **ckan_datastore_search_sql**: SQL queries (in development)
+- **ckan_datastore_search_sql**: SQL queries on DataStore
+
+### Groups
+
+- **ckan_group_list**: List groups
+- **ckan_group_show**: Show group details
+- **ckan_group_search**: Search groups by name
 
 ### Utilities
 
@@ -274,6 +258,25 @@ ckan_package_search({
 })
 ```
 
+### List tags (natural language: "show top tags about health")
+
+```typescript
+ckan_tag_list({
+  server_url: "https://www.dati.gov.it/opendata",
+  tag_query: "salute",
+  limit: 25
+})
+```
+
+### Search groups (natural language: "find groups about environment")
+
+```typescript
+ckan_group_search({
+  server_url: "https://www.dati.gov.it/opendata",
+  pattern: "ambiente"
+})
+```
+
 ### DataStore Query
 
 ```typescript
@@ -286,6 +289,15 @@ ckan_datastore_search({
 })
 ```
 
+### DataStore SQL Query
+
+```typescript
+ckan_datastore_search_sql({
+  server_url: "https://demo.ckan.org",
+  sql: "SELECT Country, COUNT(*) AS total FROM \"abc-123-def\" GROUP BY Country ORDER BY total DESC LIMIT 10"
+})
+```
+
 ## Supported CKAN Portals
 
 Some of the main compatible portals: