@aborruso/ckan-mcp-server 0.4.2 → 0.4.3

package/LOG.md

@@ -2,6 +2,12 @@
 
 ## 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/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
-
-Install in a specific project:
-
-```bash
-npm install @aborruso/ckan-mcp-server
-```
+### Option 2: Local Installation (Optional)
 
-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
 
@@ -209,6 +187,12 @@ Use the public Cloudflare Workers deployment (no local installation required):
 - **ckan_datastore_search**: Query tabular data
 - **ckan_datastore_search_sql**: SQL queries (in development)
 
+### Groups
+
+- **ckan_group_list**: List groups
+- **ckan_group_show**: Show group details
+- **ckan_group_search**: Search groups by name
+
 ### Utilities
 
 - **ckan_status_show**: Verify server status
@@ -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

package/dist/index.js

@@ -1059,6 +1059,501 @@ ${error instanceof Error ? error.message : String(error)}`
   );
 }
 
+// src/tools/tag.ts
+import { z as z6 } from "zod";
+function normalizeTagFacets(result) {
+  const searchItems = result?.search_facets?.tags?.items;
+  if (Array.isArray(searchItems)) {
+    return searchItems.map((item) => ({
+      name: item?.name || item?.display_name || String(item),
+      count: typeof item?.count === "number" ? item.count : 0,
+      display_name: item?.display_name
+    }));
+  }
+  const facets = result?.facets?.tags;
+  if (Array.isArray(facets)) {
+    if (facets.length > 0 && typeof facets[0] === "object") {
+      return facets.map((item) => ({
+        name: item?.name || item?.display_name || String(item),
+        count: typeof item?.count === "number" ? item.count : 0,
+        display_name: item?.display_name
+      }));
+    }
+    return facets.map((name) => ({ name, count: 0 }));
+  }
+  if (facets && typeof facets === "object") {
+    return Object.entries(facets).map(([name, count]) => ({
+      name,
+      count: typeof count === "number" ? count : Number(count) || 0
+    }));
+  }
+  return [];
+}
+function registerTagTools(server2) {
+  server2.registerTool(
+    "ckan_tag_list",
+    {
+      title: "List CKAN Tags",
+      description: `List tags from a CKAN server using faceting.
+
+This returns tag names with counts, optionally filtered by dataset query or tag substring.
+
+Args:
+  - server_url (string): Base URL of CKAN server
+  - q (string): Dataset search query (default: "*:*")
+  - fq (string): Filter query (optional)
+  - tag_query (string): Filter tags by substring (optional)
+  - limit (number): Max tags to return (default: 100, max: 1000)
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  List of tags with counts (from faceting)`,
+      inputSchema: z6.object({
+        server_url: z6.string().url(),
+        q: z6.string().optional().default("*:*"),
+        fq: z6.string().optional(),
+        tag_query: z6.string().optional(),
+        limit: z6.number().int().min(1).max(1e3).optional().default(100),
+        response_format: ResponseFormatSchema
+      }).strict(),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    },
+    async (params) => {
+      try {
+        const apiParams = {
+          q: params.q,
+          rows: 0,
+          "facet.field": JSON.stringify(["tags"]),
+          "facet.limit": params.limit
+        };
+        if (params.fq) apiParams.fq = params.fq;
+        const result = await makeCkanRequest(
+          params.server_url,
+          "package_search",
+          apiParams
+        );
+        let tags = normalizeTagFacets(result);
+        if (params.tag_query) {
+          const needle = params.tag_query.toLowerCase();
+          tags = tags.filter((tag) => tag.name.toLowerCase().includes(needle));
+        }
+        tags = tags.sort((a, b) => b.count - a.count || a.name.localeCompare(b.name)).slice(0, params.limit);
+        if (params.response_format === "json" /* JSON */) {
+          const output = {
+            count: tags.length,
+            tags
+          };
+          return {
+            content: [{ type: "text", text: truncateText(JSON.stringify(output, null, 2)) }],
+            structuredContent: output
+          };
+        }
+        let markdown = `# CKAN Tags
+
+`;
+        markdown += `**Server**: ${params.server_url}
+`;
+        markdown += `**Query**: ${params.q}
+`;
+        if (params.fq) markdown += `**Filter**: ${params.fq}
+`;
+        if (params.tag_query) markdown += `**Tag Query**: ${params.tag_query}
+`;
+        markdown += `**Count**: ${tags.length}
+
+`;
+        if (tags.length === 0) {
+          markdown += `No tags found.
+`;
+        } else {
+          for (const tag of tags) {
+            markdown += `- **${tag.name}**: ${tag.count}
+`;
+          }
+        }
+        return {
+          content: [{ type: "text", text: truncateText(markdown) }]
+        };
+      } catch (error) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error listing tags: ${error instanceof Error ? error.message : String(error)}`
+          }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// src/tools/group.ts
+import { z as z7 } from "zod";
+function getGroupViewUrl(serverUrl, group) {
+  const cleanServerUrl = serverUrl.replace(/\/$/, "");
+  return `${cleanServerUrl}/group/${group.name}`;
+}
+function normalizeGroupFacets(result) {
+  const items = result?.search_facets?.groups?.items;
+  if (Array.isArray(items)) {
+    return items.map((item) => ({
+      name: item?.name || item?.display_name || String(item),
+      display_name: item?.display_name,
+      count: typeof item?.count === "number" ? item.count : 0
+    }));
+  }
+  const facets = result?.facets?.groups;
+  if (Array.isArray(facets)) {
+    if (facets.length > 0 && typeof facets[0] === "object") {
+      return facets.map((item) => ({
+        name: item?.name || item?.display_name || String(item),
+        display_name: item?.display_name,
+        count: typeof item?.count === "number" ? item.count : 0
+      }));
+    }
+    return facets.map((name) => ({ name, count: 0 }));
+  }
+  if (facets && typeof facets === "object") {
+    return Object.entries(facets).map(([name, count]) => ({
+      name,
+      count: typeof count === "number" ? count : Number(count) || 0
+    }));
+  }
+  return [];
+}
+function registerGroupTools(server2) {
+  server2.registerTool(
+    "ckan_group_list",
+    {
+      title: "List CKAN Groups",
+      description: `List all groups on a CKAN server.
+
+Groups are thematic collections of datasets.
+
+Args:
+  - server_url (string): Base URL of CKAN server
+  - all_fields (boolean): Return full objects vs just names (default: false)
+  - sort (string): Sort field (default: "name asc")
+  - limit (number): Maximum results (default: 100). Use 0 to get only the count via faceting
+  - offset (number): Pagination offset (default: 0)
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  List of groups with metadata. When limit=0, returns only the count of groups with datasets.`,
+      inputSchema: z7.object({
+        server_url: z7.string().url(),
+        all_fields: z7.boolean().optional().default(false),
+        sort: z7.string().optional().default("name asc"),
+        limit: z7.number().int().min(0).optional().default(100),
+        offset: z7.number().int().min(0).optional().default(0),
+        response_format: ResponseFormatSchema
+      }).strict(),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async (params) => {
+      try {
+        if (params.limit === 0) {
+          const searchResult = await makeCkanRequest(
+            params.server_url,
+            "package_search",
+            {
+              rows: 0,
+              "facet.field": JSON.stringify(["groups"]),
+              "facet.limit": -1
+            }
+          );
+          const groupCount = searchResult.search_facets?.groups?.items?.length || 0;
+          if (params.response_format === "json" /* JSON */) {
+            return {
+              content: [{ type: "text", text: JSON.stringify({ count: groupCount }, null, 2) }],
+              structuredContent: { count: groupCount }
+            };
+          }
+          const markdown2 = `# CKAN Groups Count
+
+**Server**: ${params.server_url}
+**Total groups (with datasets)**: ${groupCount}
+`;
+          return {
+            content: [{ type: "text", text: markdown2 }]
+          };
+        }
+        const result = await makeCkanRequest(
+          params.server_url,
+          "group_list",
+          {
+            all_fields: params.all_fields,
+            sort: params.sort,
+            limit: params.limit,
+            offset: params.offset
+          }
+        );
+        if (params.response_format === "json" /* JSON */) {
+          const output = Array.isArray(result) ? { count: result.length, groups: result } : result;
+          return {
+            content: [{ type: "text", text: truncateText(JSON.stringify(output, null, 2)) }],
+            structuredContent: output
+          };
+        }
+        let markdown = `# CKAN Groups
+
+`;
+        markdown += `**Server**: ${params.server_url}
+`;
+        markdown += `**Total**: ${Array.isArray(result) ? result.length : "Unknown"}
+
+`;
+        if (Array.isArray(result)) {
+          if (params.all_fields) {
+            for (const group of result) {
+              markdown += `## ${group.title || group.name}
+
+`;
+              markdown += `- **ID**: \`${group.id}\`
+`;
+              markdown += `- **Name**: \`${group.name}\`
+`;
+              if (group.description) markdown += `- **Description**: ${group.description.substring(0, 200)}
+`;
+              markdown += `- **Datasets**: ${group.package_count || 0}
+`;
+              markdown += `- **Created**: ${formatDate(group.created)}
+`;
+              markdown += `- **Link**: ${getGroupViewUrl(params.server_url, group)}
+
+`;
+            }
+          } else {
+            markdown += result.map((name) => `- ${name}`).join("\n");
+          }
+        }
+        return {
+          content: [{ type: "text", text: truncateText(markdown) }]
+        };
+      } catch (error) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error listing groups: ${error instanceof Error ? error.message : String(error)}`
+          }],
+          isError: true
+        };
+      }
+    }
+  );
+  server2.registerTool(
+    "ckan_group_show",
+    {
+      title: "Show CKAN Group Details",
+      description: `Get details of a specific group.
+
+Args:
+  - server_url (string): Base URL of CKAN server
+  - id (string): Group ID or name
+  - include_datasets (boolean): Include list of datasets (default: true)
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  Group details with optional datasets`,
+      inputSchema: z7.object({
+        server_url: z7.string().url(),
+        id: z7.string().min(1),
+        include_datasets: z7.boolean().optional().default(true),
+        response_format: ResponseFormatSchema
+      }).strict(),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async (params) => {
+      try {
+        const result = await makeCkanRequest(
+          params.server_url,
+          "group_show",
+          {
+            id: params.id,
+            include_datasets: params.include_datasets
+          }
+        );
+        if (params.response_format === "json" /* JSON */) {
+          return {
+            content: [{ type: "text", text: truncateText(JSON.stringify(result, null, 2)) }],
+            structuredContent: result
+          };
+        }
+        let markdown = `# Group: ${result.title || result.name}
+
+`;
+        markdown += `**Server**: ${params.server_url}
+`;
+        markdown += `**Link**: ${getGroupViewUrl(params.server_url, result)}
+
+`;
+        markdown += `## Details
+
+`;
+        markdown += `- **ID**: \`${result.id}\`
+`;
+        markdown += `- **Name**: \`${result.name}\`
+`;
+        markdown += `- **Datasets**: ${result.package_count || 0}
+`;
+        markdown += `- **Created**: ${formatDate(result.created)}
+`;
+        markdown += `- **State**: ${result.state}
+
+`;
+        if (result.description) {
+          markdown += `## Description
+
+${result.description}
+
+`;
+        }
+        if (result.packages && result.packages.length > 0) {
+          markdown += `## Datasets (${result.packages.length})
+
+`;
+          for (const pkg of result.packages.slice(0, 20)) {
+            markdown += `- **${pkg.title || pkg.name}** (\`${pkg.name}\`)
+`;
+          }
+          if (result.packages.length > 20) {
+            markdown += `
+... and ${result.packages.length - 20} more datasets
+`;
+          }
+          markdown += "\n";
+        }
+        return {
+          content: [{ type: "text", text: truncateText(markdown) }]
+        };
+      } catch (error) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error fetching group: ${error instanceof Error ? error.message : String(error)}`
+          }],
+          isError: true
+        };
+      }
+    }
+  );
+  server2.registerTool(
+    "ckan_group_search",
+    {
+      title: "Search CKAN Groups by Name",
+      description: `Search for groups by name pattern.
+
+This tool provides a simpler interface than package_search for finding groups.
+Wildcards are automatically added around the search pattern.
+
+Args:
+  - server_url (string): Base URL of CKAN server
+  - pattern (string): Search pattern (e.g., "energia", "salute")
+  - response_format ('markdown' | 'json'): Output format
+
+Returns:
+  List of matching groups with dataset counts`,
+      inputSchema: z7.object({
+        server_url: z7.string().url(),
+        pattern: z7.string().min(1).describe("Search pattern (wildcards added automatically)"),
+        response_format: ResponseFormatSchema
+      }).strict(),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    },
+    async (params) => {
+      try {
+        const query = `groups:*${params.pattern}*`;
+        const result = await makeCkanRequest(
+          params.server_url,
+          "package_search",
+          {
+            q: query,
+            rows: 0,
+            "facet.field": JSON.stringify(["groups"]),
+            "facet.limit": 500
+          }
+        );
+        const groupFacets = normalizeGroupFacets(result);
+        const totalDatasets = result.count || 0;
+        if (params.response_format === "json" /* JSON */) {
+          const jsonResult = {
+            count: groupFacets.length,
+            total_datasets: totalDatasets,
+            groups: groupFacets.map((group) => ({
+              name: group.name,
+              display_name: group.display_name,
+              dataset_count: group.count
+            }))
+          };
+          return {
+            content: [{ type: "text", text: truncateText(JSON.stringify(jsonResult, null, 2)) }],
+            structuredContent: jsonResult
+          };
+        }
+        let markdown = `# CKAN Group Search Results
+
+`;
+        markdown += `**Server**: ${params.server_url}
+`;
+        markdown += `**Pattern**: "${params.pattern}"
+`;
+        markdown += `**Groups Found**: ${groupFacets.length}
+`;
+        markdown += `**Total Datasets**: ${totalDatasets}
+
+`;
+        if (groupFacets.length === 0) {
+          markdown += `No groups found matching pattern "${params.pattern}".
+`;
+        } else {
+          markdown += `## Matching Groups
+
+`;
+          markdown += `| Group | Datasets |
+`;
+          markdown += `|-------|----------|
+`;
+          for (const group of groupFacets) {
+            markdown += `| ${group.display_name || group.name} | ${group.count} |
+`;
+          }
+        }
+        return {
+          content: [{ type: "text", text: truncateText(markdown) }]
+        };
+      } catch (error) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error searching groups: ${error instanceof Error ? error.message : String(error)}`
+          }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/resources/dataset.ts
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 
@@ -1232,7 +1727,7 @@ function registerAllResources(server2) {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.2"
+    version: "0.4.3"
   });
 }
 function registerAll(server2) {
@@ -1240,6 +1735,8 @@ function registerAll(server2) {
   registerOrganizationTools(server2);
   registerDatastoreTools(server2);
   registerStatusTools(server2);
+  registerTagTools(server2);
+  registerGroupTools(server2);
   registerAllResources(server2);
 }
 

package/dist/worker.js

@@ -373,7 +373,7 @@ Returns:
 **Site Title**: ${r.site_title||"N/A"}
 **Site URL**: ${r.site_url||"N/A"}
 `}],structuredContent:r}}catch(r){return{content:[{type:"text",text:`Server appears to be offline or not a valid CKAN instance:
-${r instanceof Error?r.message:String(r)}`}],isError:!0}}})}function Bn(t){let e=t.hostname;if(!e)throw new Error("Invalid ckan:// URI: missing server hostname");let r=t.pathname.split("/").filter(a=>a.length>0);if(r.length<2)throw new Error(`Invalid ckan:// URI: expected /{type}/{id}, got ${t.pathname}`);let[n,...o]=r,s=o.join("/");if(!n||!s)throw new Error("Invalid ckan:// URI: missing type or id");return{server:`https://${e}`,type:n,id:s}}function av(t){t.registerResource("ckan-dataset",new vr("ckan://{server}/dataset/{id}",{list:void 0}),{title:"CKAN Dataset",description:"Access dataset metadata from any CKAN server. URI format: ckan://{server}/dataset/{id}",mimeType:"application/json"},async(e,r)=>{try{let{server:n}=Bn(e),o=r.id,s=await ze(n,"package_show",{id:o}),i=xe(JSON.stringify(s,null,2));return{contents:[{uri:e.href,mimeType:"application/json",text:i}]}}catch(n){let o=n instanceof Error?n.message:String(n);return{contents:[{uri:e.href,mimeType:"text/plain",text:`Error fetching dataset: ${o}`}]}}})}function cv(t){t.registerResource("ckan-resource",new vr("ckan://{server}/resource/{id}",{list:void 0}),{title:"CKAN Resource",description:"Access resource metadata and download URL from any CKAN server. URI format: ckan://{server}/resource/{id}",mimeType:"application/json"},async(e,r)=>{try{let{server:n}=Bn(e),o=r.id,s=await ze(n,"resource_show",{id:o}),i=xe(JSON.stringify(s,null,2));return{contents:[{uri:e.href,mimeType:"application/json",text:i}]}}catch(n){let o=n instanceof Error?n.message:String(n);return{contents:[{uri:e.href,mimeType:"text/plain",text:`Error fetching resource: ${o}`}]}}})}function uv(t){t.registerResource("ckan-organization",new vr("ckan://{server}/organization/{name}",{list:void 0}),{title:"CKAN Organization",description:"Access organization metadata from any CKAN server. URI format: ckan://{server}/organization/{name}",mimeType:"application/json"},async(e,r)=>{try{let{server:n}=Bn(e),o=r.name,s=await ze(n,"organization_show",{id:o,include_datasets:!1}),i=xe(JSON.stringify(s,null,2));return{contents:[{uri:e.href,mimeType:"application/json",text:i}]}}catch(n){let o=n instanceof Error?n.message:String(n);return{contents:[{uri:e.href,mimeType:"text/plain",text:`Error fetching organization: ${o}`}]}}})}function lv(t){av(t),cv(t),uv(t)}function dv(){return new na({name:"ckan-mcp-server",version:"0.4.1"})}function pv(t){nv(t),ov(t),sv(t),iv(t),lv(t)}var va=class{constructor(e={}){this._started=!1,this._streamMapping=new Map,this._requestToStreamMapping=new Map,this._requestResponseMap=new Map,this._initialized=!1,this._enableJsonResponse=!1,this._standaloneSseStreamId="_GET_stream",this.sessionIdGenerator=e.sessionIdGenerator,this._enableJsonResponse=e.enableJsonResponse??!1,this._eventStore=e.eventStore,this._onsessioninitialized=e.onsessioninitialized,this._onsessionclosed=e.onsessionclosed,this._allowedHosts=e.allowedHosts,this._allowedOrigins=e.allowedOrigins,this._enableDnsRebindingProtection=e.enableDnsRebindingProtection??!1,this._retryInterval=e.retryInterval}async start(){if(this._started)throw new Error("Transport already started");this._started=!0}createJsonErrorResponse(e,r,n,o){let s={code:r,message:n};return o?.data!==void 0&&(s.data=o.data),new Response(JSON.stringify({jsonrpc:"2.0",error:s,id:null}),{status:e,headers:{"Content-Type":"application/json",...o?.headers}})}validateRequestHeaders(e){if(this._enableDnsRebindingProtection){if(this._allowedHosts&&this._allowedHosts.length>0){let r=e.headers.get("host");if(!r||!this._allowedHosts.includes(r)){let n=`Invalid Host header: ${r}`;return this.onerror?.(new Error(n)),this.createJsonErrorResponse(403,-32e3,n)}}if(this._allowedOrigins&&this._allowedOrigins.length>0){let r=e.headers.get("origin");if(r&&!this._allowedOrigins.includes(r)){let n=`Invalid Origin header: ${r}`;return this.onerror?.(new Error(n)),this.createJsonErrorResponse(403,-32e3,n)}}}}async handleRequest(e,r){let n=this.validateRequestHeaders(e);if(n)return n;switch(e.method){case"POST":return this.handlePostRequest(e,r);case"GET":return this.handleGetRequest(e);case"DELETE":return this.handleDeleteRequest(e);default:return this.handleUnsupportedRequest()}}async writePrimingEvent(e,r,n,o){if(!this._eventStore||o<"2025-11-25")return;let s=await this._eventStore.storeEvent(n,{}),i=`id: ${s}
+${r instanceof Error?r.message:String(r)}`}],isError:!0}}})}function Bn(t){let e=t.hostname;if(!e)throw new Error("Invalid ckan:// URI: missing server hostname");let r=t.pathname.split("/").filter(a=>a.length>0);if(r.length<2)throw new Error(`Invalid ckan:// URI: expected /{type}/{id}, got ${t.pathname}`);let[n,...o]=r,s=o.join("/");if(!n||!s)throw new Error("Invalid ckan:// URI: missing type or id");return{server:`https://${e}`,type:n,id:s}}function av(t){t.registerResource("ckan-dataset",new vr("ckan://{server}/dataset/{id}",{list:void 0}),{title:"CKAN Dataset",description:"Access dataset metadata from any CKAN server. URI format: ckan://{server}/dataset/{id}",mimeType:"application/json"},async(e,r)=>{try{let{server:n}=Bn(e),o=r.id,s=await ze(n,"package_show",{id:o}),i=xe(JSON.stringify(s,null,2));return{contents:[{uri:e.href,mimeType:"application/json",text:i}]}}catch(n){let o=n instanceof Error?n.message:String(n);return{contents:[{uri:e.href,mimeType:"text/plain",text:`Error fetching dataset: ${o}`}]}}})}function cv(t){t.registerResource("ckan-resource",new vr("ckan://{server}/resource/{id}",{list:void 0}),{title:"CKAN Resource",description:"Access resource metadata and download URL from any CKAN server. URI format: ckan://{server}/resource/{id}",mimeType:"application/json"},async(e,r)=>{try{let{server:n}=Bn(e),o=r.id,s=await ze(n,"resource_show",{id:o}),i=xe(JSON.stringify(s,null,2));return{contents:[{uri:e.href,mimeType:"application/json",text:i}]}}catch(n){let o=n instanceof Error?n.message:String(n);return{contents:[{uri:e.href,mimeType:"text/plain",text:`Error fetching resource: ${o}`}]}}})}function uv(t){t.registerResource("ckan-organization",new vr("ckan://{server}/organization/{name}",{list:void 0}),{title:"CKAN Organization",description:"Access organization metadata from any CKAN server. URI format: ckan://{server}/organization/{name}",mimeType:"application/json"},async(e,r)=>{try{let{server:n}=Bn(e),o=r.name,s=await ze(n,"organization_show",{id:o,include_datasets:!1}),i=xe(JSON.stringify(s,null,2));return{contents:[{uri:e.href,mimeType:"application/json",text:i}]}}catch(n){let o=n instanceof Error?n.message:String(n);return{contents:[{uri:e.href,mimeType:"text/plain",text:`Error fetching organization: ${o}`}]}}})}function lv(t){av(t),cv(t),uv(t)}function dv(){return new na({name:"ckan-mcp-server",version:"0.4.2"})}function pv(t){nv(t),ov(t),sv(t),iv(t),lv(t)}var va=class{constructor(e={}){this._started=!1,this._streamMapping=new Map,this._requestToStreamMapping=new Map,this._requestResponseMap=new Map,this._initialized=!1,this._enableJsonResponse=!1,this._standaloneSseStreamId="_GET_stream",this.sessionIdGenerator=e.sessionIdGenerator,this._enableJsonResponse=e.enableJsonResponse??!1,this._eventStore=e.eventStore,this._onsessioninitialized=e.onsessioninitialized,this._onsessionclosed=e.onsessionclosed,this._allowedHosts=e.allowedHosts,this._allowedOrigins=e.allowedOrigins,this._enableDnsRebindingProtection=e.enableDnsRebindingProtection??!1,this._retryInterval=e.retryInterval}async start(){if(this._started)throw new Error("Transport already started");this._started=!0}createJsonErrorResponse(e,r,n,o){let s={code:r,message:n};return o?.data!==void 0&&(s.data=o.data),new Response(JSON.stringify({jsonrpc:"2.0",error:s,id:null}),{status:e,headers:{"Content-Type":"application/json",...o?.headers}})}validateRequestHeaders(e){if(this._enableDnsRebindingProtection){if(this._allowedHosts&&this._allowedHosts.length>0){let r=e.headers.get("host");if(!r||!this._allowedHosts.includes(r)){let n=`Invalid Host header: ${r}`;return this.onerror?.(new Error(n)),this.createJsonErrorResponse(403,-32e3,n)}}if(this._allowedOrigins&&this._allowedOrigins.length>0){let r=e.headers.get("origin");if(r&&!this._allowedOrigins.includes(r)){let n=`Invalid Origin header: ${r}`;return this.onerror?.(new Error(n)),this.createJsonErrorResponse(403,-32e3,n)}}}}async handleRequest(e,r){let n=this.validateRequestHeaders(e);if(n)return n;switch(e.method){case"POST":return this.handlePostRequest(e,r);case"GET":return this.handleGetRequest(e);case"DELETE":return this.handleDeleteRequest(e);default:return this.handleUnsupportedRequest()}}async writePrimingEvent(e,r,n,o){if(!this._eventStore||o<"2025-11-25")return;let s=await this._eventStore.storeEvent(n,{}),i=`id: ${s}
 data: 
 
 `;this._retryInterval!==void 0&&(i=`id: ${s}
@@ -384,4 +384,4 @@ data:
 `;return o&&(s+=`id: ${o}
 `),s+=`data: ${JSON.stringify(n)}
 
-`,e.enqueue(r.encode(s)),!0}catch{return!1}}handleUnsupportedRequest(){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:"Method not allowed."},id:null}),{status:405,headers:{Allow:"GET, POST, DELETE","Content-Type":"application/json"}})}async handlePostRequest(e,r){try{let n=e.headers.get("accept");if(!n?.includes("application/json")||!n.includes("text/event-stream"))return this.createJsonErrorResponse(406,-32e3,"Not Acceptable: Client must accept both application/json and text/event-stream");let o=e.headers.get("content-type");if(!o||!o.includes("application/json"))return this.createJsonErrorResponse(415,-32e3,"Unsupported Media Type: Content-Type must be application/json");let s={headers:Object.fromEntries(e.headers.entries())},i;if(r?.parsedBody!==void 0)i=r.parsedBody;else try{i=await e.json()}catch{return this.createJsonErrorResponse(400,-32700,"Parse error: Invalid JSON")}let a;try{Array.isArray(i)?a=i.map(_=>Zu.parse(_)):a=[Zu.parse(i)]}catch{return this.createJsonErrorResponse(400,-32700,"Parse error: Invalid JSON-RPC message")}let c=a.some(Mu);if(c){if(this._initialized&&this.sessionId!==void 0)return this.createJsonErrorResponse(400,-32600,"Invalid Request: Server already initialized");if(a.length>1)return this.createJsonErrorResponse(400,-32600,"Invalid Request: Only one initialization request is allowed");this.sessionId=this.sessionIdGenerator?.(),this._initialized=!0,this.sessionId&&this._onsessioninitialized&&await Promise.resolve(this._onsessioninitialized(this.sessionId))}if(!c){let _=this.validateSession(e);if(_)return _;let x=this.validateProtocolVersion(e);if(x)return x}if(!a.some(cr)){for(let _ of a)this.onmessage?.(_,{authInfo:r?.authInfo,requestInfo:s});return new Response(null,{status:202})}let l=crypto.randomUUID(),d=a.find(_=>Mu(_)),g=d?d.params.protocolVersion:e.headers.get("mcp-protocol-version")??Tm;if(this._enableJsonResponse)return new Promise(_=>{this._streamMapping.set(l,{resolveJson:_,cleanup:()=>{this._streamMapping.delete(l)}});for(let x of a)cr(x)&&this._requestToStreamMapping.set(x.id,l);for(let x of a)this.onmessage?.(x,{authInfo:r?.authInfo,requestInfo:s})});let h=new TextEncoder,p,f=new ReadableStream({start:_=>{p=_},cancel:()=>{this._streamMapping.delete(l)}}),m={"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive"};this.sessionId!==void 0&&(m["mcp-session-id"]=this.sessionId);for(let _ of a)cr(_)&&(this._streamMapping.set(l,{controller:p,encoder:h,cleanup:()=>{this._streamMapping.delete(l);try{p.close()}catch{}}}),this._requestToStreamMapping.set(_.id,l));await this.writePrimingEvent(p,h,l,g);for(let _ of a){let x,w;cr(_)&&this._eventStore&&g>="2025-11-25"&&(x=()=>{this.closeSSEStream(_.id)},w=()=>{this.closeStandaloneSSEStream()}),this.onmessage?.(_,{authInfo:r?.authInfo,requestInfo:s,closeSSEStream:x,closeStandaloneSSEStream:w})}return new Response(f,{status:200,headers:m})}catch(n){return this.onerror?.(n),this.createJsonErrorResponse(400,-32700,"Parse error",{data:String(n)})}}async handleDeleteRequest(e){let r=this.validateSession(e);if(r)return r;let n=this.validateProtocolVersion(e);return n||(await Promise.resolve(this._onsessionclosed?.(this.sessionId)),await this.close(),new Response(null,{status:200}))}validateSession(e){if(this.sessionIdGenerator===void 0)return;if(!this._initialized)return this.createJsonErrorResponse(400,-32e3,"Bad Request: Server not initialized");let r=e.headers.get("mcp-session-id");if(!r)return this.createJsonErrorResponse(400,-32e3,"Bad Request: Mcp-Session-Id header is required");if(r!==this.sessionId)return this.createJsonErrorResponse(404,-32001,"Session not found")}validateProtocolVersion(e){let r=e.headers.get("mcp-protocol-version");if(r!==null&&!lo.includes(r))return this.createJsonErrorResponse(400,-32e3,`Bad Request: Unsupported protocol version: ${r} (supported versions: ${lo.join(", ")})`)}async close(){this._streamMapping.forEach(({cleanup:e})=>{e()}),this._streamMapping.clear(),this._requestResponseMap.clear(),this.onclose?.()}closeSSEStream(e){let r=this._requestToStreamMapping.get(e);if(!r)return;let n=this._streamMapping.get(r);n&&n.cleanup()}closeStandaloneSSEStream(){let e=this._streamMapping.get(this._standaloneSseStreamId);e&&e.cleanup()}async send(e,r){let n=r?.relatedRequestId;if((qt(e)||_n(e))&&(n=e.id),n===void 0){if(qt(e)||_n(e))throw new Error("Cannot send a response on a standalone SSE stream unless resuming a previous client request");let i;this._eventStore&&(i=await this._eventStore.storeEvent(this._standaloneSseStreamId,e));let a=this._streamMapping.get(this._standaloneSseStreamId);if(a===void 0)return;a.controller&&a.encoder&&this.writeSSEEvent(a.controller,a.encoder,e,i);return}let o=this._requestToStreamMapping.get(n);if(!o)throw new Error(`No connection established for request ID: ${String(n)}`);let s=this._streamMapping.get(o);if(!this._enableJsonResponse&&s?.controller&&s?.encoder){let i;this._eventStore&&(i=await this._eventStore.storeEvent(o,e)),this.writeSSEEvent(s.controller,s.encoder,e,i)}if(qt(e)||_n(e)){this._requestResponseMap.set(n,e);let i=Array.from(this._requestToStreamMapping.entries()).filter(([c,u])=>u===o).map(([c])=>c);if(i.every(c=>this._requestResponseMap.has(c))){if(!s)throw new Error(`No connection established for request ID: ${String(n)}`);if(this._enableJsonResponse&&s.resolveJson){let c={"Content-Type":"application/json"};this.sessionId!==void 0&&(c["mcp-session-id"]=this.sessionId);let u=i.map(l=>this._requestResponseMap.get(l));u.length===1?s.resolveJson(new Response(JSON.stringify(u[0]),{status:200,headers:c})):s.resolveJson(new Response(JSON.stringify(u),{status:200,headers:c}))}else s.cleanup();for(let c of i)this._requestResponseMap.delete(c),this._requestToStreamMapping.delete(c)}}}};var fv=dv();pv(fv);var mv=new va({sessionIdGenerator:void 0,enableJsonResponse:!0});await fv.connect(mv);var Hq={async fetch(t){let e=new URL(t.url);if(t.method==="GET"&&e.pathname==="/health")return new Response(JSON.stringify({status:"ok",version:"0.4.1",tools:7,resources:3,runtime:"cloudflare-workers"}),{headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*"}});if(e.pathname==="/mcp")try{let r=await mv.handleRequest(t),n=new Headers(r.headers);return n.set("Access-Control-Allow-Origin","*"),new Response(r.body,{status:r.status,statusText:r.statusText,headers:n})}catch(r){return console.error("Worker error:",r),new Response(JSON.stringify({jsonrpc:"2.0",error:{code:-32603,message:"Internal error",data:r instanceof Error?r.message:String(r)},id:null}),{status:500,headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*"}})}return new Response("Not Found",{status:404,headers:{"Access-Control-Allow-Origin":"*"}})}};export{Hq as default};
+`,e.enqueue(r.encode(s)),!0}catch{return!1}}handleUnsupportedRequest(){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:"Method not allowed."},id:null}),{status:405,headers:{Allow:"GET, POST, DELETE","Content-Type":"application/json"}})}async handlePostRequest(e,r){try{let n=e.headers.get("accept");if(!n?.includes("application/json")||!n.includes("text/event-stream"))return this.createJsonErrorResponse(406,-32e3,"Not Acceptable: Client must accept both application/json and text/event-stream");let o=e.headers.get("content-type");if(!o||!o.includes("application/json"))return this.createJsonErrorResponse(415,-32e3,"Unsupported Media Type: Content-Type must be application/json");let s={headers:Object.fromEntries(e.headers.entries())},i;if(r?.parsedBody!==void 0)i=r.parsedBody;else try{i=await e.json()}catch{return this.createJsonErrorResponse(400,-32700,"Parse error: Invalid JSON")}let a;try{Array.isArray(i)?a=i.map(_=>Zu.parse(_)):a=[Zu.parse(i)]}catch{return this.createJsonErrorResponse(400,-32700,"Parse error: Invalid JSON-RPC message")}let c=a.some(Mu);if(c){if(this._initialized&&this.sessionId!==void 0)return this.createJsonErrorResponse(400,-32600,"Invalid Request: Server already initialized");if(a.length>1)return this.createJsonErrorResponse(400,-32600,"Invalid Request: Only one initialization request is allowed");this.sessionId=this.sessionIdGenerator?.(),this._initialized=!0,this.sessionId&&this._onsessioninitialized&&await Promise.resolve(this._onsessioninitialized(this.sessionId))}if(!c){let _=this.validateSession(e);if(_)return _;let x=this.validateProtocolVersion(e);if(x)return x}if(!a.some(cr)){for(let _ of a)this.onmessage?.(_,{authInfo:r?.authInfo,requestInfo:s});return new Response(null,{status:202})}let l=crypto.randomUUID(),d=a.find(_=>Mu(_)),g=d?d.params.protocolVersion:e.headers.get("mcp-protocol-version")??Tm;if(this._enableJsonResponse)return new Promise(_=>{this._streamMapping.set(l,{resolveJson:_,cleanup:()=>{this._streamMapping.delete(l)}});for(let x of a)cr(x)&&this._requestToStreamMapping.set(x.id,l);for(let x of a)this.onmessage?.(x,{authInfo:r?.authInfo,requestInfo:s})});let h=new TextEncoder,p,f=new ReadableStream({start:_=>{p=_},cancel:()=>{this._streamMapping.delete(l)}}),m={"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive"};this.sessionId!==void 0&&(m["mcp-session-id"]=this.sessionId);for(let _ of a)cr(_)&&(this._streamMapping.set(l,{controller:p,encoder:h,cleanup:()=>{this._streamMapping.delete(l);try{p.close()}catch{}}}),this._requestToStreamMapping.set(_.id,l));await this.writePrimingEvent(p,h,l,g);for(let _ of a){let x,w;cr(_)&&this._eventStore&&g>="2025-11-25"&&(x=()=>{this.closeSSEStream(_.id)},w=()=>{this.closeStandaloneSSEStream()}),this.onmessage?.(_,{authInfo:r?.authInfo,requestInfo:s,closeSSEStream:x,closeStandaloneSSEStream:w})}return new Response(f,{status:200,headers:m})}catch(n){return this.onerror?.(n),this.createJsonErrorResponse(400,-32700,"Parse error",{data:String(n)})}}async handleDeleteRequest(e){let r=this.validateSession(e);if(r)return r;let n=this.validateProtocolVersion(e);return n||(await Promise.resolve(this._onsessionclosed?.(this.sessionId)),await this.close(),new Response(null,{status:200}))}validateSession(e){if(this.sessionIdGenerator===void 0)return;if(!this._initialized)return this.createJsonErrorResponse(400,-32e3,"Bad Request: Server not initialized");let r=e.headers.get("mcp-session-id");if(!r)return this.createJsonErrorResponse(400,-32e3,"Bad Request: Mcp-Session-Id header is required");if(r!==this.sessionId)return this.createJsonErrorResponse(404,-32001,"Session not found")}validateProtocolVersion(e){let r=e.headers.get("mcp-protocol-version");if(r!==null&&!lo.includes(r))return this.createJsonErrorResponse(400,-32e3,`Bad Request: Unsupported protocol version: ${r} (supported versions: ${lo.join(", ")})`)}async close(){this._streamMapping.forEach(({cleanup:e})=>{e()}),this._streamMapping.clear(),this._requestResponseMap.clear(),this.onclose?.()}closeSSEStream(e){let r=this._requestToStreamMapping.get(e);if(!r)return;let n=this._streamMapping.get(r);n&&n.cleanup()}closeStandaloneSSEStream(){let e=this._streamMapping.get(this._standaloneSseStreamId);e&&e.cleanup()}async send(e,r){let n=r?.relatedRequestId;if((qt(e)||_n(e))&&(n=e.id),n===void 0){if(qt(e)||_n(e))throw new Error("Cannot send a response on a standalone SSE stream unless resuming a previous client request");let i;this._eventStore&&(i=await this._eventStore.storeEvent(this._standaloneSseStreamId,e));let a=this._streamMapping.get(this._standaloneSseStreamId);if(a===void 0)return;a.controller&&a.encoder&&this.writeSSEEvent(a.controller,a.encoder,e,i);return}let o=this._requestToStreamMapping.get(n);if(!o)throw new Error(`No connection established for request ID: ${String(n)}`);let s=this._streamMapping.get(o);if(!this._enableJsonResponse&&s?.controller&&s?.encoder){let i;this._eventStore&&(i=await this._eventStore.storeEvent(o,e)),this.writeSSEEvent(s.controller,s.encoder,e,i)}if(qt(e)||_n(e)){this._requestResponseMap.set(n,e);let i=Array.from(this._requestToStreamMapping.entries()).filter(([c,u])=>u===o).map(([c])=>c);if(i.every(c=>this._requestResponseMap.has(c))){if(!s)throw new Error(`No connection established for request ID: ${String(n)}`);if(this._enableJsonResponse&&s.resolveJson){let c={"Content-Type":"application/json"};this.sessionId!==void 0&&(c["mcp-session-id"]=this.sessionId);let u=i.map(l=>this._requestResponseMap.get(l));u.length===1?s.resolveJson(new Response(JSON.stringify(u[0]),{status:200,headers:c})):s.resolveJson(new Response(JSON.stringify(u),{status:200,headers:c}))}else s.cleanup();for(let c of i)this._requestResponseMap.delete(c),this._requestToStreamMapping.delete(c)}}}};var fv=dv();pv(fv);var mv=new va({sessionIdGenerator:void 0,enableJsonResponse:!0});await fv.connect(mv);var Hq={async fetch(t){let e=new URL(t.url);if(t.method==="GET"&&e.pathname==="/health")return new Response(JSON.stringify({status:"ok",version:"0.4.2",tools:7,resources:3,runtime:"cloudflare-workers"}),{headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*"}});if(e.pathname==="/mcp")try{let r=await mv.handleRequest(t),n=new Headers(r.headers);return n.set("Access-Control-Allow-Origin","*"),new Response(r.body,{status:r.status,statusText:r.statusText,headers:n})}catch(r){return console.error("Worker error:",r),new Response(JSON.stringify({jsonrpc:"2.0",error:{code:-32603,message:"Internal error",data:r instanceof Error?r.message:String(r)},id:null}),{status:500,headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*"}})}return new Response("Not Found",{status:404,headers:{"Access-Control-Allow-Origin":"*"}})}};export{Hq as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aborruso/ckan-mcp-server",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "MCP server for interacting with CKAN open data portals",
   "main": "dist/index.js",
   "type": "module",