@aborruso/ckan-mcp-server 0.4.49 → 0.4.51

package/AGENTS.md

@@ -118,6 +118,43 @@ Node `>=18`. Worker build in `wrangler.toml`. Vitest coverage thresholds enforce
 
 Minimal focused diffs. No unrelated refactors. Update tests for behavior changes. Avoid editing `dist/`.
 
+## Pre-commit Checklist
+
+Before committing and pushing any locally testable change:
+1. Build: `npm run build`
+2. Automated tests: `npm test` — all must pass
+3. Manual queries: run real requests against the built server to verify end-to-end behavior
+
+### How to run manual queries
+
+```bash
+# Terminal 1 — start server
+TRANSPORT=http PORT=3001 node dist/index.js
+
+# Terminal 2 — call a tool
+curl -s -X POST http://localhost:3001/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc":"2.0",
+    "method":"tools/call",
+    "params":{
+      "name":"ckan_package_search",
+      "arguments":{
+        "server_url":"https://www.dati.gov.it/opendata",
+        "q":"ambiente",
+        "page":1,
+        "page_size":3
+      }
+    },
+    "id":1
+  }'
+```
+
+- Always include both `Content-Type: application/json` and `Accept: application/json, text/event-stream`
+- Use `node dist/index.js` directly, not `npm start`
+- Use port 3001 to avoid conflicts
+
 ## Project Layout
 
 `src/index.ts` entry, `src/server.ts` wiring, `src/tools/` handlers, `src/utils/` helpers, `src/resources/` templates, `src/transport/` stdio/HTTP. `tests/unit/` utilities, `tests/integration/` behavior, `tests/fixtures/` mocks.

package/LOG.md

@@ -1,5 +1,40 @@
 # LOG
 
+## 2026-02-27 (v0.4.51)
+
+- refactor: domain types for all tool files — `CkanTag`, `CkanResource`, `CkanPackage`, `CkanOrganization`, `CkanField`, `CkanDatastoreResult` in `src/types.ts`; `any` reduced 32 → 1
+- refactor: extract rendering functions from handler closures → named exports in `datastore.ts`, `organization.ts`, `group.ts`, `status.ts`; +26 unit tests
+- fix: datastore table — skip `_id` column, increase cell truncation 50 → 80 chars
+- fix: org/group show — dataset heading now shows `showing M of N returned — T total`
+- tests: 191 → 272; all passing
+
+## 2026-02-27 (continued 2)
+
+- fix: datastore table — skip `_id` column, increase cell truncation 50→80 chars
+- fix: org/group show — `## Datasets (N)` → `## Datasets (showing M of N returned — T total)`
+- tests: 270 → 272; all passing
+
+## 2026-02-27 (continued)
+
+- refactor: extract markdown rendering from handler closures into exported functions in `datastore.ts`, `organization.ts`, `group.ts`, `status.ts`
+- add 26 unit tests across 4 new test files (`datastore-formatting`, `organization-formatting`, `group-formatting`, `status-formatting`)
+- test count: 244 → 270; all passing
+
+## 2026-02-27
+
+- refactor: add CKAN domain types (`CkanTag`, `CkanResource`, `CkanPackage`, `CkanOrganization`, `CkanField`, `CkanDatastoreResult`) to `src/types.ts`
+- replace `any` in exported tool functions across `package.ts`, `datastore.ts`, `organization.ts`, `group.ts`, `quality.ts`, `tag.ts` — 32 → 1 remaining (internal handler variable)
+- no behavioral change; 244 tests passing
+
+## 2026-02-26 (v0.4.50)
+
+- `ckan_list_resources`: add `format_filter` param (case-insensitive, client-side) — e.g. 72 resources → 8 CSV; header shows "Total: 72 (showing 8 CSV)"
+- `ckan_package_search`: OR tip on zero results — when a plain multi-term query returns 0, suggest the OR version (e.g. `"a b c"` → `"a OR b OR c"`)
+- `ckan_package_search`: accent fallback — if query returns 0 results and contains accented chars, retry with accent-stripped query; note shown in output
+- `ckan_package_show`: always show DataStore status per resource
+  - `✅ Available` / `❌ Not available` / `❓ Not reported by portal`
+  - Previously silent when field absent (e.g. dati.gov.it); now explicit
+
 ## 2026-02-25 (v0.4.49)
 
 - Disable DataStore Table UI component (MCP Apps) pending use-case design

package/README.md

@@ -18,7 +18,7 @@ MCP (Model Context Protocol) server for interacting with CKAN-based open data po
 - 📄 MCP Resource Templates for direct data access
 - 🧭 Guided MCP prompts for common workflows
 - 🛡️ Browser-like headers to avoid WAF blocks
-- 🧪 Test suite with 214 tests (100% passing)
+- 🧪 Comprehensive test suite (100% passing)
 
 👉 If you want to dive deeper, the [**AI-generated DeepWiki**](https://deepwiki.com/ondata/ckan-mcp-server) is very well done.
 
@@ -188,6 +188,25 @@ npm install -g @aborruso/ckan-mcp-server
 
 ⚠️ **Warning**: Demo instance with 100,000 requests/month shared globally across all users. Not reliable for production use.
 
+**Claude Desktop on Windows reading from a local MCP server installed on WSL2**:
+
+```json
+{
+  "mcpServers": {
+    "ckan": {
+      "command": "wsl.exe",
+      "args": [
+        "-e",
+        "/usr/local/bin/node",
+        "/home/username/projects/ckan-mcp-server/dist/index.js"
+      ]
+    }
+  }
+}
+```
+
+This requires the server to be built (`npm run build`) inside the WSL2 environment before use.
+
 ### Web Tools
 
 #### ChatGPT