@aborruso/ckan-mcp-server 0.4.3 → 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,13 @@
 
 ## 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`

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

@@ -185,7 +185,7 @@ 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
 
@@ -289,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: