@aborruso/ckan-mcp-server 0.4.87 → 0.4.88

package/LOG.md

@@ -1,5 +1,15 @@
 # LOG
 
+## 2026-03-19
+
+### v0.4.88
+
+- fix(`tools/organization.ts`): `ckan_organization_search` now shows `view_url` in markdown table and JSON output; `ckan_organization_show` JSON includes `view_url` — all using `portals.json` custom patterns
+
+
+
+- evals(`evals/tool-selection`): tool selection eval pipeline — synthetic NL query generation (Gemini, 1583 records), train/eval split, fine-tuning Qwen2.5-0.5B with Unsloth on Colab T4; 86.3% accuracy on 8 tools; model published at huggingface.co/aborruso/ckan-tool-selector
+
 ## 2026-03-17
 
 - fix(`tools/sparql.ts`): add `; charset=utf-8` to POST Content-Type — fixes accented chars corruption in SPARQL queries (issue #22)

package/dist/index.js

@@ -1919,7 +1919,7 @@ function compactOrganizationList(result) {
     })
   };
 }
-function compactOrganizationShow(result) {
+function compactOrganizationShow(result, serverUrl) {
   return {
     id: result.id,
     name: result.name,
@@ -1928,6 +1928,7 @@ function compactOrganizationShow(result) {
     image_url: result.image_url || null,
     package_count: result.package_count ?? 0,
     created: result.created || null,
+    view_url: getOrganizationViewUrl(serverUrl, result),
     packages: (result.packages || []).map((pkg) => ({
       id: pkg.id,
       name: pkg.name,
@@ -2174,7 +2175,7 @@ Typical workflow: ckan_organization_show \u2192 ckan_package_show (inspect a dat
           }
         );
         if (params.response_format === "json" /* JSON */) {
-          const compact = compactOrganizationShow(result);
+          const compact = compactOrganizationShow(result, params.server_url);
           return {
             content: [{ type: "text", text: truncateJson(compact) }],
             structuredContent: compact
@@ -2251,7 +2252,8 @@ Typical workflow: ckan_organization_search \u2192 ckan_organization_show (get de
             organizations: orgFacets.map((item) => ({
               name: item.name,
               display_name: item.display_name,
-              dataset_count: item.count
+              dataset_count: item.count,
+              view_url: getOrganizationViewUrl(params.server_url, { name: item.name })
             }))
           };
           return {
@@ -2281,12 +2283,13 @@ Typical workflow: ckan_organization_search \u2192 ckan_organization_show (get de
           markdown += `## Matching Organizations
 
 `;
-          markdown += `| Organization | Datasets |
+          markdown += `| Organization | Datasets | Link |
 `;
-          markdown += `|--------------|----------|
+          markdown += `|--------------|----------|------|
 `;
           for (const org of orgFacets) {
-            markdown += `| ${org.display_name || org.name} | ${org.count} |
+            const viewUrl = getOrganizationViewUrl(params.server_url, { name: org.name });
+            markdown += `| ${org.display_name || org.name} | ${org.count} | ${viewUrl} |
 `;
           }
         }
@@ -5124,7 +5127,7 @@ var registerAllPrompts = (server2) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.87"
+    version: "0.4.88"
   });
 }
 function registerAll(server2) {

package/dist/worker.js

@@ -825,7 +825,7 @@ Returns:
   Total dataset count, categories ranked by count, file formats ranked by count, organizations ranked by count.
 
 Typical workflow: ckan_catalog_stats (understand the portal) \u2192 ckan_package_search (query specific data)`,inputSchema:v.object({server_url:v.string().url().describe("Base URL of the CKAN server (e.g., https://dati.comune.messina.it)"),facet_limit:v.number().int().min(1).max(100).optional().default(20).describe("Max entries per facet section (default 20)"),response_format:fe}).strict(),annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1}},async e=>{try{let r=await F(e.server_url,"package_search",{q:"*:*",rows:0,"facet.field":JSON.stringify(["groups","res_format","organization"]),"facet.limit":e.facet_limit});if(e.response_format==="json")return{content:[{type:"text",text:W(JSON.stringify({total:r.count,facets:r.facets},null,2))}]};let n=DO(e.server_url,r.count,r.facets);return{content:[{type:"text",text:W(se(n))}]}}catch(r){return{content:[{type:"text",text:`Error retrieving catalog stats: ${r instanceof Error?r.message:String(r)}`}],isError:!0}}})}var Na=25,Yf=1e3;function ZO(t){let e=t.replace(/#[^\n]*/g,"");if(!/\bSELECT\b/i.test(e))throw new Error("Only SELECT queries are supported (not CONSTRUCT, ASK, DESCRIBE, or write operations).")}function LO(t,e){return/\bLIMIT\b/i.test(t)?t:`${t.trimEnd()}
-LIMIT ${e}`}async function UO(t,e){if(Hf(t),new URL(t).protocol!=="https:")throw new Error("Only HTTPS endpoints are allowed");let o=Av(t)?.method??"POST",s={Accept:"application/sparql-results+json","User-Agent":"Mozilla/5.0 (compatible; CKAN-MCP-Server/1.0)"},i=new AbortController,a=setTimeout(()=>i.abort(),15e3),c;try{if(o==="GET"){let u=new URL(t);u.searchParams.set("query",e),c=await fetch(u.toString(),{method:"GET",signal:i.signal,headers:s})}else if(c=await fetch(t,{method:"POST",signal:i.signal,headers:{...s,"Content-Type":"application/sparql-query"},body:e}),c.status===403||c.status===405){let u=new URL(t);u.searchParams.set("query",e),c=await fetch(u.toString(),{method:"GET",signal:i.signal,headers:s})}}finally{clearTimeout(a)}if(!c.ok)throw new Error(`SPARQL endpoint error (${c.status}): ${c.statusText}`);return c.json()}function FO(t,e){let r=t.head.vars,n=t.results.bindings,o=`# SPARQL Query Results
+LIMIT ${e}`}async function UO(t,e){if(Hf(t),new URL(t).protocol!=="https:")throw new Error("Only HTTPS endpoints are allowed");let o=Av(t)?.method??"POST",s={Accept:"application/sparql-results+json","User-Agent":"Mozilla/5.0 (compatible; CKAN-MCP-Server/1.0)"},i=new AbortController,a=setTimeout(()=>i.abort(),15e3),c;try{if(o==="GET"){let u=new URL(t);u.searchParams.set("query",e),c=await fetch(u.toString(),{method:"GET",signal:i.signal,headers:s})}else if(c=await fetch(t,{method:"POST",signal:i.signal,headers:{...s,"Content-Type":"application/sparql-query; charset=utf-8"},body:e}),c.status===403||c.status===405){let u=new URL(t);u.searchParams.set("query",e),c=await fetch(u.toString(),{method:"GET",signal:i.signal,headers:s})}}finally{clearTimeout(a)}if(!c.ok)throw new Error(`SPARQL endpoint error (${c.status}): ${c.statusText}`);return c.json()}function FO(t,e){let r=t.head.vars,n=t.results.bindings,o=`# SPARQL Query Results
 
 `;if(o+=`**Endpoint**: ${e}
 `,o+=`**Rows**: ${n.length}
@@ -1086,7 +1086,7 @@ ckan_package_search({
 })
 \`\`\`
 
-If the portal supports HVD classification, look for datasets with fields like \`hvd_category\` or \`applicable_legislation\`.`,$b=t=>{t.registerPrompt(aC,{title:"Search High-Value Datasets (HVD)",description:"Guided prompt to find High-Value Datasets (HVD) on a CKAN portal. Automatically uses the correct filter field from portal configuration.",argsSchema:{server_url:v.string().url().describe("Base URL of the CKAN server"),rows:v.coerce.number().int().positive().default(10).describe("Max results to return")}},async({server_url:e,rows:r})=>{let n=so(e);return ht(cC(e,r,n?.category_field??null))})};var Sb=t=>{vb(t),bb(t),wb(t),xb(t),kb(t),$b(t)};function zb(){return new ma({name:"ckan-mcp-server",version:"0.4.86"})}function Tb(t){Kv(t),Jv(t),Gv(t),Qv(t),Yv(t),eb(t),ib(t),ab(t),cb(t),ub(t),lb(t),_b(t),Sb(t)}var ja=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}
+If the portal supports HVD classification, look for datasets with fields like \`hvd_category\` or \`applicable_legislation\`.`,$b=t=>{t.registerPrompt(aC,{title:"Search High-Value Datasets (HVD)",description:"Guided prompt to find High-Value Datasets (HVD) on a CKAN portal. Automatically uses the correct filter field from portal configuration.",argsSchema:{server_url:v.string().url().describe("Base URL of the CKAN server"),rows:v.coerce.number().int().positive().default(10).describe("Max results to return")}},async({server_url:e,rows:r})=>{let n=so(e);return ht(cC(e,r,n?.category_field??null))})};var Sb=t=>{vb(t),bb(t),wb(t),xb(t),kb(t),$b(t)};function zb(){return new ma({name:"ckan-mcp-server",version:"0.4.87"})}function Tb(t){Kv(t),Jv(t),Gv(t),Qv(t),Yv(t),eb(t),ib(t),ab(t),cb(t),ub(t),lb(t),_b(t),Sb(t)}var ja=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}
@@ -1280,4 +1280,4 @@ data:
     </div>
   </div>
 </body>
-</html>`,{headers:{"Content-Type":"text/html; charset=utf-8","Access-Control-Allow-Origin":"*"}});if(t.method==="GET"&&e.pathname==="/health")return new Response(JSON.stringify({status:"ok",version:"0.4.86",tools:20,resources:7,prompts:6,runtime:"cloudflare-workers"}),{headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*"}});if(e.pathname==="/mcp"){if(t.method==="OPTIONS")return new Response(null,{status:204,headers:{"Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, DELETE, OPTIONS","Access-Control-Allow-Headers":"Content-Type, Accept, Authorization, Mcp-Session-Id","Access-Control-Max-Age":"86400"}});try{let r=t.clone();try{let s=await r.json();if(s?.method==="tools/call"&&s?.params?.name){let i=s.params.name,a=s.params.arguments??{},c={tool:i,server:a.server_url??a.endpoint_url??""};a.q!==void 0&&(c.q=a.q),a.fq!==void 0&&(c.fq=a.fq),a.query!==void 0&&(c.query=a.query),a.id!==void 0&&(c.id=a.id),a.name!==void 0&&(c.name=a.name),a.pattern!==void 0&&(c.pattern=a.pattern),a.resource_id!==void 0&&(c.resource_id=a.resource_id),a.format_filter!==void 0&&(c.format_filter=a.format_filter),a.sort!==void 0&&(c.sort=a.sort),a.rows!==void 0&&(c.rows=a.rows),a.limit!==void 0&&(c.limit=a.limit),a.sql!==void 0&&(c.sql=String(a.sql).slice(0,200)),a.country!==void 0&&(c.country=a.country),a.language!==void 0&&(c.language=a.language),a.has_datastore!==void 0&&(c.has_datastore=a.has_datastore),a.min_datasets!==void 0&&(c.min_datasets=a.min_datasets),console.log(JSON.stringify(c))}}catch{}let n=await Eb.handleRequest(t),o=new Headers(n.headers);return o.set("Access-Control-Allow-Origin","*"),o.set("X-Service-Notice","Demo instance - 100k requests/day shared quota"),o.set("X-Recommendation","https://github.com/ondata/ckan-mcp-server#installation"),new Response(n.body,{status:n.status,statusText:n.statusText,headers:o})}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{oF as default};
+</html>`,{headers:{"Content-Type":"text/html; charset=utf-8","Access-Control-Allow-Origin":"*"}});if(t.method==="GET"&&e.pathname==="/health")return new Response(JSON.stringify({status:"ok",version:"0.4.87",tools:20,resources:7,prompts:6,runtime:"cloudflare-workers"}),{headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*"}});if(e.pathname==="/mcp"){if(t.method==="OPTIONS")return new Response(null,{status:204,headers:{"Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, DELETE, OPTIONS","Access-Control-Allow-Headers":"Content-Type, Accept, Authorization, Mcp-Session-Id","Access-Control-Max-Age":"86400"}});try{let r=t.clone();try{let s=await r.json();if(s?.method==="tools/call"&&s?.params?.name){let i=s.params.name,a=s.params.arguments??{},c={tool:i,server:a.server_url??a.endpoint_url??""};a.q!==void 0&&(c.q=a.q),a.fq!==void 0&&(c.fq=a.fq),a.query!==void 0&&(c.query=a.query),a.id!==void 0&&(c.id=a.id),a.name!==void 0&&(c.name=a.name),a.pattern!==void 0&&(c.pattern=a.pattern),a.resource_id!==void 0&&(c.resource_id=a.resource_id),a.format_filter!==void 0&&(c.format_filter=a.format_filter),a.sort!==void 0&&(c.sort=a.sort),a.rows!==void 0&&(c.rows=a.rows),a.limit!==void 0&&(c.limit=a.limit),a.sql!==void 0&&(c.sql=String(a.sql).slice(0,200)),a.country!==void 0&&(c.country=a.country),a.language!==void 0&&(c.language=a.language),a.has_datastore!==void 0&&(c.has_datastore=a.has_datastore),a.min_datasets!==void 0&&(c.min_datasets=a.min_datasets),console.log(JSON.stringify(c))}}catch{}let n=await Eb.handleRequest(t),o=new Headers(n.headers);return o.set("Access-Control-Allow-Origin","*"),o.set("X-Service-Notice","Demo instance - 100k requests/day shared quota"),o.set("X-Recommendation","https://github.com/ondata/ckan-mcp-server#installation"),new Response(n.body,{status:n.status,statusText:n.statusText,headers:o})}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{oF as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aborruso/ckan-mcp-server",
-  "version": "0.4.87",
+  "version": "0.4.88",
   "mcpName": "io.github.aborruso/ckan-mcp-server",
   "description": "MCP server for interacting with CKAN open data portals",
   "main": "dist/index.js",