@aborruso/ckan-mcp-server 0.4.11 → 0.4.14

package/CLAUDE.md

@@ -41,7 +41,7 @@ The server exposes MCP tools for:
 # Build project (uses esbuild - fast and lightweight)
 npm run build
 
-# Run test suite (179 tests - unit + integration)
+# Run test suite (191 tests - unit + integration)
 npm test
 
 # Watch mode for tests during development
@@ -73,7 +73,7 @@ npm run deploy            # Deploy to Cloudflare Workers
 The project uses **esbuild** for compilation and **vitest** for testing:
 
 - **Build**: Ultra-fast builds (milliseconds instead of minutes)
-- **Tests**: 179 tests (unit + integration) with 100% success rate
+- **Tests**: 191 tests (unit + integration) with 100% success rate
 - **Coverage**: ~39% overall (utils: 98%, tools: 15-20%) - available via vitest with v8 coverage engine
 
 The `build:tsc` script is available as a fallback but can cause memory issues in some environments (particularly WSL). Always use `npm run build` which uses esbuild.
@@ -88,12 +88,12 @@ The project has a comprehensive test suite using **Vitest**:
 tests/
 ├── unit/
 │   ├── formatting.test.ts    # Utility functions (19 tests)
-│   ├── http.test.ts           # HTTP client (6 tests)
+│   ├── http.test.ts           # HTTP client (11 tests)
 │   └── uri.test.ts            # URI parsing (11 tests)
 ├── integration/
-│   ├── package.test.ts        # Package tools (29 tests)
+│   ├── package.test.ts        # Package tools (31 tests)
 │   ├── organization.test.ts   # Organization tools (6 tests)
-│   ├── datastore.test.ts      # DataStore tools (17 tests)
+│   ├── datastore.test.ts      # DataStore tools (19 tests)
 │   ├── resources.test.ts      # MCP Resources (11 tests)
 │   └── status.test.ts         # Status tools (2 tests)
 └── fixtures/
@@ -101,7 +101,7 @@ tests/
     └── errors/                # Error scenario mocks
 ```
 
-**Test Coverage**: 179 tests total (85 unit + 94 integration)
+**Test Coverage**: 191 tests total (117 unit + 74 integration)
 
 When making changes:
 1. Run tests before committing: `npm test`
@@ -341,7 +341,7 @@ To test with Claude Desktop, add the MCP configuration to the config file.
 - Direct data access for datasets, resources, organizations
 
 **v0.2.0 (2026-01-08)**: Comprehensive test suite
-- 179 tests (unit + integration)
+- 191 tests (unit + integration)
 - ~39% code coverage (utils well-tested, tools improving)
 
 **v0.1.0 (2026-01-08)**: Modular refactoring

package/LOG.md

@@ -1,7 +1,73 @@
 # LOG
 
+## 2026-01-22
+
+### Date Query Auto-Conversion (v0.4.14)
+
+- **Feature**: Auto-convert NOW-based date math for `modified` and `issued` fields
+- **Problem**: CKAN Solr supports `NOW-XDAYS` syntax only on `metadata_modified` and `metadata_created` fields
+- **Solution**: New `convertDateMathForUnsupportedFields()` automatically converts queries like `modified:[NOW-30DAYS TO NOW]` to ISO dates `modified:[2025-12-23T... TO 2026-01-22T...]`
+- **Supported fields**: `modified`, `issued` (auto-converted) | `metadata_modified`, `metadata_created` (native NOW support)
+- **Supported units**: DAYS, MONTHS, YEARS (singular and plural forms)
+- **Tests**: +10 unit tests (201 total, all passing)
+- **Documentation**: Updated tool description with NOW syntax limitations and examples
+- **Files**: `src/utils/search.ts`, `src/tools/package.ts`, `tests/unit/search.test.ts`
+- **No breaking changes**: Backward compatible - existing queries work unchanged
+
+## 2026-01-19
+
+### Search Parser Escaping
+- **Fix**: Escape Solr special characters when forcing `text:(...)` queries
+- **Tests**: Added unit coverage for escaping and forced parser output
+- **Files**: `src/utils/search.ts`, `tests/unit/search.test.ts`, `README.md`
+
+## 2026-01-17
+
+### Documentation Alignment
+- **Test counts updated**: README.md (184→190), PRD.md (130→190)
+- **Version updated**: PRD.md version 0.4.7→0.4.12
+- **Date updated**: PRD.md last updated 2026-01-10→2026-01-17
+- **Verification**: All 13 tools, 7 resources, 5 prompts implemented and documented
+- **Files**: `README.md`, `PRD.md`
+
+### GitHub Templates
+- **Issue templates**: Added bug report and feature request YAML forms
+  - Bug report: CKAN portal URL, steps, expected/actual, error, Node version
+  - Feature request: problem/use case, proposed solution, alternatives
+  - Auto-labels: `bug` and `enhancement`
+- **Issue chooser**: Routes questions to Discussions Q&A
+- **PR template**: Description, related issue, test/docs checklist
+- **Files**: `.github/ISSUE_TEMPLATE/{bug_report,feature_request,config}.yml`, `.github/PULL_REQUEST_TEMPLATE.md`
+
+## 2026-01-16
+
+### Demo Video Preparation
+- **Documentation**: Created complete demo video documentation suite in `docs/video/`
+  - `demo-script.md` - Commands and technical notes for 4 use cases
+  - `demo-expected-results.md` - Actual test results with data samples
+  - `demo-recording-guide.md` - Step-by-step recording guide with voiceover scripts
+  - `pre-recording-checklist.md` - Practical day-of checklist
+  - `demo-fallback-options.md` - Comprehensive fallback strategies for 8 scenarios
+  - `demo-timing-report.md` - Performance analysis and timing verification
+- **Testing**: Verified all demo commands working with dati.gov.it
+  - Portal overview: 67,614 datasets, top 10 organizations (~5s)
+  - Targeted search: 263 Milano transport datasets (~10s)
+  - Dataset details: Complete metadata with CSV/JSON resources (~10s)
+  - DuckDB analysis: DESCRIBE, SUMMARIZE, SAMPLE all working (~8s total)
+- **Target**: 5-7 minute video demonstrating MCP convenience for Italian open data
+- **Status**: Ready for recording with high confidence level
+
 ## 2026-01-15
 
+### Version 0.4.12 - Dataset filter resources
+- **Feature**: Added `ckan://{server}/.../datasets` resource templates for group, organization, tag, and format filters
+- **Fix**: Map `ckan://` hostnames to portal API base URLs (e.g., dati.gov.it → /opendata)
+- **Fix**: Format filtering now matches `res_format` and `distribution_format` (with case variants)
+- **Docs**: Updated README and future ideas with new URI templates
+- **Docs**: Updated `docs/proposta-spunti-datos-gob-es-mcp.md` marking resource templates as completed
+- **Tests**: Added unit tests for dataset filter resource templates
+- **Files**: New `src/resources/dataset-filters.ts`, updates in `src/resources/index.ts`, `src/worker.ts`
+
 ### Version 0.4.11 - Prompt argument coercion
 - **Fix**: Prompt arguments now coerce numeric strings (e.g., rows) for MCP prompt requests
 - **Docs**: Updated evaluation notes for 0.4.11

package/NOTICE.md

@@ -0,0 +1,77 @@
+# Third-Party Software Notices
+
+This software incorporates material from third parties. The following sets forth attribution notices for third-party software that may be included in this software.
+
+## Production Dependencies
+
+### @modelcontextprotocol/sdk
+- **License**: MIT License
+- **Copyright**: Copyright (c) 2024 Anthropic, PBC
+- **Repository**: https://github.com/modelcontextprotocol/typescript-sdk
+- **Description**: Official TypeScript SDK for the Model Context Protocol (MCP)
+
+### axios
+- **License**: MIT License
+- **Copyright**: Copyright (c) 2014-present Matt Zabriskie & Collaborators
+- **Repository**: https://github.com/axios/axios
+- **Description**: Promise-based HTTP client for the browser and node.js
+
+### express
+- **License**: MIT License
+- **Copyright**: Copyright (c) 2009-2014 TJ Holowaychuk <tj@vision-media.ca>
+- **Copyright**: Copyright (c) 2013-2014 Roman Shtylman <shtylman+expressjs@gmail.com>
+- **Copyright**: Copyright (c) 2014-2015 Douglas Christopher Wilson <doug@somethingdoug.com>
+- **Repository**: https://github.com/expressjs/express
+- **Description**: Fast, unopinionated, minimalist web framework for Node.js
+
+### zod
+- **License**: MIT License
+- **Copyright**: Copyright (c) 2025 Colin McDonnell
+- **Repository**: https://github.com/colinhacks/zod
+- **Description**: TypeScript-first schema validation with static type inference
+
+## Development Dependencies (Build Tools)
+
+### TypeScript
+- **License**: Apache License 2.0
+- **Copyright**: Copyright (c) Microsoft Corporation
+- **Repository**: https://github.com/microsoft/TypeScript
+- **Description**: TypeScript language compiler
+
+### esbuild
+- **License**: MIT License
+- **Copyright**: Copyright (c) 2020 Evan Wallace
+- **Repository**: https://github.com/evanw/esbuild
+- **Description**: An extremely fast JavaScript bundler
+
+### Vitest
+- **License**: MIT License
+- **Copyright**: Copyright (c) 2021-Present Anthony Fu, Matías Capeletto
+- **Repository**: https://github.com/vitest-dev/vitest
+- **Description**: Next generation testing framework
+
+### Wrangler
+- **License**: MIT OR Apache-2.0 (dual license)
+- **Copyright**: Copyright (c) 2017-2022 Cloudflare, Inc.
+- **Repository**: https://github.com/cloudflare/workers-sdk
+- **Description**: Cloudflare Workers CLI and deployment tool
+
+---
+
+## License Information
+
+All production dependencies use permissive open-source licenses (MIT, ISC, BSD) that are fully compatible with this project's MIT License.
+
+Full license texts for all dependencies are available in the respective `node_modules` directories and on their respective repository pages.
+
+## Compliance
+
+This project complies with all license obligations of its dependencies:
+- Attribution notices are preserved
+- Original copyright statements are maintained
+- License files are distributed with the software
+- No modifications have been made to third-party code without proper attribution
+
+---
+
+For questions about licensing, please contact: Andrea Borruso <aborruso@gmail.com>

package/PRD.md

@@ -2,9 +2,9 @@
 
 ## CKAN MCP Server
 
-**Version**: 0.4.7  
-**Last Updated**: 2026-01-10  
-**Author**: onData  
+**Version**: 0.4.12
+**Last Updated**: 2026-01-17
+**Author**: onData
 **Status**: Production
 
 ---
@@ -214,7 +214,7 @@ An MCP server that exposes tools to interact with CKAN API v3, enabling AI agent
 - `wrangler@^4.58.0` - Cloudflare Workers CLI
 
 **Test Framework**:
-- `vitest@^4.0.16` - Test runner (130 tests, 100% passing)
+- `vitest@^4.0.16` - Test runner (191 tests, 100% passing)
 
 ### 4.2 Architecture Diagram
 
@@ -825,7 +825,7 @@ ckan_package_search({
 ### 10.3 Testing & Quality
 
 ✅ **Current State**:
-- 130 unit and integration tests (100% passing)
+- 191 unit and integration tests (100% passing)
 - vitest test runner
 - Coverage for all 13 tools
 - Fixtures for offline testing
@@ -860,7 +860,7 @@ ckan_package_search({
 - **Memory Usage**: < 50MB runtime (Node.js), Workers limits apply
 - **Response Time**: < 30s (CKAN API timeout), < 10s (Workers)
 - **Cold Start**: < 60ms (Cloudflare Workers)
-- **Test Coverage**: 130 tests (100% passing)
+- **Test Coverage**: 191 tests (100% passing)
 
 ### 11.2 Distribution Metrics
 

package/README.md

@@ -1,6 +1,6 @@
 [![npm version](https://img.shields.io/npm/v/@aborruso/ckan-mcp-server)](https://www.npmjs.com/package/@aborruso/ckan-mcp-server)
-[![GitHub](https://img.shields.io/badge/github-aborruso%2Fckan--mcp--server-blue?logo=github)](https://github.com/aborruso/ckan-mcp-server)
-[![deepwiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/aborruso/ckan-mcp-server)
+[![GitHub](https://img.shields.io/badge/github-ondata%2Fckan--mcp--server-blue?logo=github)](https://github.com/ondata/ckan-mcp-server)
+[![deepwiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ondata/ckan-mcp-server)
 
 # CKAN MCP Server
 
@@ -17,11 +17,11 @@ MCP (Model Context Protocol) server for interacting with CKAN-based open data po
 - ⚡ Pagination and faceting support
 - 📄 MCP Resource Templates for direct data access
 - 🧭 Guided MCP prompts for common workflows
-- 🧪 Test suite with 184 tests (100% passing)
+- 🧪 Test suite with 191 tests (100% passing)
 
 ---
 
-👉 If you want to dive deeper, the [**AI-generated DeepWiki**](https://deepwiki.com/aborruso/ckan-mcp-server) is very well done.
+👉 If you want to dive deeper, the [**AI-generated DeepWiki**](https://deepwiki.com/ondata/ckan-mcp-server) is very well done.
 
 ---
 
@@ -45,7 +45,7 @@ npm install
 # Build with esbuild (fast, ~4ms)
 npm run build
 
-# Run tests (184 tests)
+# Run tests (191 tests)
 npm test
 ```
 
@@ -87,6 +87,8 @@ Use the public Workers endpoint (no local install required):
 
 Want your own deployment? See [DEPLOYMENT.md](docs/DEPLOYMENT.md).
 
+## Guides
+
 ### Claude Desktop Configuration
 
 Configuration file location:
@@ -115,22 +117,29 @@ Then add to `claude_desktop_config.json`:
 }
 ```
 
-#### Option 2: Local Installation (Optional)
+#### Option 2: Local Project Installation (Optional)
+
+If you want to install the server in a specific project:
 
-If you installed locally (see Installation), use this config:
+```bash
+cd your-project
+npm install @aborruso/ckan-mcp-server
+```
+
+Then add to `claude_desktop_config.json`:
 
 ```json
 {
   "mcpServers": {
     "ckan": {
-      "command": "node",
-      "args": ["/absolute/path/to/project/node_modules/@username/ckan-mcp-server/dist/index.js"]
+      "command": "npx",
+      "args": ["@aborruso/ckan-mcp-server"]
     }
   }
 }
 ```
 
-Replace `/absolute/path/to/project` with your actual project path.
+**Note**: `npx` will use the locally installed package in `node_modules`. Make sure to install the package first.
 
 #### Option 3: From Source
 
@@ -147,6 +156,8 @@ If you cloned the repository:
 }
 ```
 
+[A detailed guide](https://github.com/ondata/ckan-mcp-server/discussions/4#discussion-9359684)
+
 #### Option 4: Cloudflare Workers (HTTP transport)
 
 Use the public Cloudflare Workers deployment (no local installation required):
@@ -165,6 +176,13 @@ Use the public Cloudflare Workers deployment (no local installation required):
 
 **Note**: This uses the public endpoint. You can also deploy your own Workers instance and use that URL instead.
 
+### Web Tools Configuration
+
+- [ChatGPT web](docs/guide/chatgpt/chatgpt_web.md)
+- [Claude web](docs/guide/claude/claude_web.md)
+
+These guides are based on a public demo server, which has a limit of 100,000 calls per month. For reliable usage, it is recommended to install the CKAN MCP Server on your own machine.
+
 ## Available Tools
 
 ### Search and Discovery
@@ -172,13 +190,13 @@ Use the public Cloudflare Workers deployment (no local installation required):
 - **ckan_package_search**: Search datasets with Solr queries
 - **ckan_find_relevant_datasets**: Rank datasets by relevance score
 - **ckan_package_show**: Complete details of a dataset
-- **ckan_package_list**: List all datasets
 - **ckan_tag_list**: List tags with counts
 
 ### Organizations
 
 - **ckan_organization_list**: List all organizations
 - **ckan_organization_show**: Details of an organization
+- **ckan_organization_search**: Search organizations by name
 
 ### DataStore
 
@@ -202,6 +220,10 @@ Direct data access via `ckan://` URI scheme:
 - `ckan://{server}/dataset/{id}` - Dataset metadata
 - `ckan://{server}/resource/{id}` - Resource metadata and download URL
 - `ckan://{server}/organization/{name}` - Organization details
+- `ckan://{server}/group/{name}/datasets` - Datasets by group (theme)
+- `ckan://{server}/organization/{name}/datasets` - Datasets by organization
+- `ckan://{server}/tag/{name}/datasets` - Datasets by tag
+- `ckan://{server}/format/{format}/datasets` - Datasets by resource format (res_format + distribution_format)
 
 Examples:
 
@@ -209,6 +231,10 @@ Examples:
 ckan://dati.gov.it/dataset/vaccini-covid
 ckan://demo.ckan.org/resource/abc-123
 ckan://data.gov/organization/sample-org
+ckan://dati.gov.it/group/ambiente/datasets
+ckan://dati.gov.it/organization/regione-toscana/datasets
+ckan://dati.gov.it/tag/turismo/datasets
+ckan://dati.gov.it/format/csv/datasets
 ```
 
 ## Guided Prompts
@@ -256,6 +282,7 @@ ckan_package_search({
   rows: 0
 })
 ```
+Note: when `query_parser: "text"` is used, Solr special characters in the query are escaped automatically.
 
 ### Rank datasets by relevance (natural language: "find most relevant datasets about urban mobility")
 
@@ -354,15 +381,15 @@ Some of the main compatible portals:
 
 ### Portal View URL Templates
 
-Some CKAN portals expose non-standard web URLs for viewing datasets or organizations. To support those cases, this project ships with `src/portals.json`, which maps known portal API URLs (and aliases) to custom view URL templates.
+Some CKAN portals expose non-standard web URLs for viewing datasets or organizations. To support those cases, this project ships with [`src/portals.json`](src/portals.json), which maps known portal API URLs (and aliases) to custom view URL templates.
 
 When generating a dataset or organization view link, the server:
 
-- matches the `server_url` against `api_url` and `api_url_aliases` in `src/portals.json`
+- matches the `server_url` against `api_url` and `api_url_aliases` in [`src/portals.json`](src/portals.json)
 - uses the portal-specific `dataset_view_url` / `organization_view_url` template when available
 - falls back to the generic defaults (`{server_url}/dataset/{name}` and `{server_url}/organization/{name}`)
 
-You can extend `src/portals.json` by adding new entries under `portals` if a portal uses different web URL patterns.
+You can extend [`src/portals.json`](src/portals.json) by adding new entries under `portals` if a portal uses different web URL patterns.
 
 ## Advanced Solr Queries
 
@@ -539,7 +566,7 @@ ckan-mcp-server/
 │   └── transport/
 │       ├── stdio.ts        # Stdio transport
 │       └── http.ts         # HTTP transport
-├── tests/                  # Test suite (184 tests)
+├── tests/                  # Test suite (191 tests)
 ├── dist/                   # Compiled files (generated)
 ├── package.json
 └── README.md
@@ -547,6 +574,8 @@ ckan-mcp-server/
 
 ## Development
 
+This project uses [OpenSpec](https://github.com/Fission-AI/OpenSpec) to manage change proposals and keep specifications aligned with implementation.
+
 ### Testing
 
 The project uses **Vitest** for automated testing:
@@ -640,7 +669,9 @@ Contributions are welcome! Please:
 
 ## License
 
-MIT License - See LICENSE.txt file for complete details.
+MIT License - See [LICENSE.txt](LICENSE.txt) for complete details.
+
+Third-party attributions: See [NOTICE.md](NOTICE.md) for third-party software notices and information.
 
 ## Useful Links
 
@@ -650,10 +681,7 @@ MIT License - See LICENSE.txt file for complete details.
 
 ## Support
 
-For issues or questions:
-
-- Open an issue on GitHub
-- Contact onData: https://www.ondata.it/
+For issues or questions, [open an issue on GitHub](https://github.com/ondata/ckan-mcp-server/issues/new/choose).
 
 ---
 

package/dist/index.js

@@ -110,6 +110,13 @@ var portals_default = {
 function normalizeUrl(url) {
   return url.replace(/\/$/, "");
 }
+function extractHostname(url) {
+  try {
+    return new URL(url).hostname;
+  } catch {
+    return null;
+  }
+}
 function getPortalConfig(serverUrl) {
   const cleanServerUrl = normalizeUrl(serverUrl);
   const portal = portals_default.portals.find((p) => {
@@ -129,6 +136,13 @@ function getPortalSearchConfig(serverUrl) {
 function normalizePortalUrl(serverUrl) {
   return normalizeUrl(serverUrl);
 }
+function getPortalApiUrlForHostname(hostname) {
+  const portal = portals_default.portals.find((p) => {
+    const urls = [p.api_url, ...p.api_url_aliases || []];
+    return urls.some((url) => extractHostname(url) === hostname);
+  });
+  return portal ? normalizeUrl(portal.api_url) : null;
+}
 
 // src/utils/url-generator.ts
 function getDatasetViewUrl(serverUrl, pkg) {
@@ -147,9 +161,38 @@ function getOrganizationViewUrl(serverUrl, org) {
 // src/utils/search.ts
 var DEFAULT_SEARCH_QUERY = "*:*";
 var FIELD_QUERY_PATTERN = /\b[a-zA-Z_][\w-]*:/;
+var SOLR_SPECIAL_CHARS = /[+\-!(){}[\]^"~*?:\\/|&]/g;
 function isFieldedQuery(query) {
   return FIELD_QUERY_PATTERN.test(query);
 }
+function escapeSolrQuery(query) {
+  return query.replace(SOLR_SPECIAL_CHARS, "\\$&");
+}
+function convertDateMathForUnsupportedFields(query) {
+  const now = /* @__PURE__ */ new Date();
+  const nowIso = now.toISOString();
+  const pattern = /\b(?!metadata_)(modified|issued):\[NOW-(\d+)(DAYS?|MONTHS?|YEARS?)\s+TO\s+NOW\]/gi;
+  return query.replace(pattern, (match, field, amount, unit) => {
+    const amountNum = parseInt(amount, 10);
+    const startDate = new Date(now);
+    const normalizedUnit = unit.toLowerCase().replace(/s$/, "");
+    switch (normalizedUnit) {
+      case "day":
+        startDate.setDate(startDate.getDate() - amountNum);
+        break;
+      case "month":
+        startDate.setMonth(startDate.getMonth() - amountNum);
+        break;
+      case "year":
+        startDate.setFullYear(startDate.getFullYear() - amountNum);
+        break;
+      default:
+        return match;
+    }
+    const startIso = startDate.toISOString();
+    return `${field}:[${startIso} TO ${nowIso}]`;
+  });
+}
 function resolveSearchQuery(serverUrl, query, parserOverride) {
   const portalSearchConfig = getPortalSearchConfig(serverUrl);
   const portalForce = portalSearchConfig.force_text_field ?? false;
@@ -162,7 +205,8 @@ function resolveSearchQuery(serverUrl, query, parserOverride) {
     const trimmedQuery = query.trim();
     forceTextField = trimmedQuery !== DEFAULT_SEARCH_QUERY && !isFieldedQuery(trimmedQuery);
   }
-  const effectiveQuery = forceTextField ? `text:(${query})` : query;
+  let effectiveQuery = forceTextField ? `text:(${escapeSolrQuery(query)})` : query;
+  effectiveQuery = convertDateMathForUnsupportedFields(effectiveQuery);
   return { effectiveQuery, forcedTextField: forceTextField };
 }
 
@@ -315,6 +359,9 @@ Query Syntax (parameter q):
     - NOW/DAY, NOW/MONTH (round down)
     - Combined: "metadata_modified:[NOW-2MONTHS TO NOW]"
     - Example: "metadata_created:[NOW-1YEAR TO *]"
+    - IMPORTANT: NOW syntax works on metadata_modified and metadata_created fields
+    - For 'modified' and 'issued' fields, NOW syntax is auto-converted to ISO dates
+    - Manual ISO dates always work: "modified:[2026-01-15T00:00:00Z TO *]"
 
   Field existence:
     - Exists: "field:*" or "field:[* TO *]"
@@ -333,6 +380,7 @@ Examples:
   - Proximity: { q: "notes:"open data"~3" }
   - Date range: { q: "metadata_modified:[2024-01-01T00:00:00Z TO 2024-12-31T23:59:59Z]" }
   - Date math: { q: "metadata_modified:[NOW-6MONTHS TO *]" }
+  - Date math (auto-converted): { q: "modified:[NOW-30DAYS TO NOW]" }
   - Field exists: { q: "organization:* AND num_resources:[1 TO *]" }
   - Boosting: { q: "title:climate^2 OR notes:climate" }
   - Filter org: { fq: "organization:regione-siciliana" }
@@ -2073,7 +2121,7 @@ function parseCkanUri(uri) {
   if (!type || !id) {
     throw new Error("Invalid ckan:// URI: missing type or id");
   }
-  const server2 = `https://${hostname}`;
+  const server2 = getPortalApiUrlForHostname(hostname) || `https://${hostname}`;
   return { server: server2, type, id };
 }
 
@@ -2215,11 +2263,110 @@ function registerOrganizationResource(server2) {
   );
 }
 
+// src/resources/dataset-filters.ts
+import { ResourceTemplate as ResourceTemplate4 } from "@modelcontextprotocol/sdk/server/mcp.js";
+var escapeSolrTerm = (value) => value.replace(/["\\]/g, "\\$&");
+var buildFormatFilter = (rawFormat) => {
+  const format = rawFormat.trim();
+  const variants = [format];
+  const upper = format.toUpperCase();
+  if (upper !== format) {
+    variants.push(upper);
+  }
+  const fields = ["res_format", "distribution_format"];
+  const clauses = fields.flatMap(
+    (field) => variants.map((value) => `${field}:"${escapeSolrTerm(value)}"`)
+  );
+  return `(${clauses.join(" OR ")})`;
+};
+var registerDatasetFilterResource = (server2, config) => {
+  server2.registerResource(
+    config.name,
+    new ResourceTemplate4(config.template, { list: void 0 }),
+    {
+      title: config.title,
+      description: config.description,
+      mimeType: "application/json"
+    },
+    async (uri, variables) => {
+      try {
+        const { server: serverUrl } = parseCkanUri(uri);
+        const fq = config.buildFq(variables);
+        const result = await makeCkanRequest(serverUrl, "package_search", {
+          q: "*:*",
+          fq
+        });
+        const content = truncateText(JSON.stringify(result, null, 2));
+        return {
+          contents: [
+            {
+              uri: uri.href,
+              mimeType: "application/json",
+              text: content
+            }
+          ]
+        };
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+          contents: [
+            {
+              uri: uri.href,
+              mimeType: "text/plain",
+              text: `Error fetching datasets: ${errorMessage}`
+            }
+          ]
+        };
+      }
+    }
+  );
+};
+function registerGroupDatasetsResource(server2) {
+  registerDatasetFilterResource(server2, {
+    name: "ckan-group-datasets",
+    template: "ckan://{server}/group/{name}/datasets",
+    title: "CKAN Group Datasets",
+    description: "List datasets in a CKAN group (theme). URI format: ckan://{server}/group/{name}/datasets",
+    buildFq: (variables) => `groups:"${escapeSolrTerm(variables.name)}"`
+  });
+}
+function registerOrganizationDatasetsResource(server2) {
+  registerDatasetFilterResource(server2, {
+    name: "ckan-organization-datasets",
+    template: "ckan://{server}/organization/{name}/datasets",
+    title: "CKAN Organization Datasets",
+    description: "List datasets for a CKAN organization. URI format: ckan://{server}/organization/{name}/datasets",
+    buildFq: (variables) => `organization:"${escapeSolrTerm(variables.name)}"`
+  });
+}
+function registerTagDatasetsResource(server2) {
+  registerDatasetFilterResource(server2, {
+    name: "ckan-tag-datasets",
+    template: "ckan://{server}/tag/{name}/datasets",
+    title: "CKAN Tag Datasets",
+    description: "List datasets matching a CKAN tag. URI format: ckan://{server}/tag/{name}/datasets",
+    buildFq: (variables) => `tags:"${escapeSolrTerm(variables.name)}"`
+  });
+}
+function registerFormatDatasetsResource(server2) {
+  registerDatasetFilterResource(server2, {
+    name: "ckan-format-datasets",
+    template: "ckan://{server}/format/{format}/datasets",
+    title: "CKAN Format Datasets",
+    description: "List datasets by resource format. URI format: ckan://{server}/format/{format}/datasets",
+    buildFq: (variables) => buildFormatFilter(variables.format)
+  });
+}
+
 // src/resources/index.ts
 function registerAllResources(server2) {
   registerDatasetResource(server2);
   registerResourceResource(server2);
   registerOrganizationResource(server2);
+  registerGroupDatasetsResource(server2);
+  registerOrganizationDatasetsResource(server2);
+  registerTagDatasetsResource(server2);
+  registerFormatDatasetsResource(server2);
 }
 
 // src/prompts/theme.ts
@@ -2462,7 +2609,7 @@ var registerAllPrompts = (server2) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.11"
+    version: "0.4.13"
   });
 }
 function registerAll(server2) {