@aborruso/ckan-mcp-server 0.4.39 → 0.4.40

package/LOG.md

@@ -1,5 +1,31 @@
 # LOG
 
+## 2026-02-20
+
+- Add DataStore Table Viewer (MCP Apps interactive UI)
+  - New MCP resource `ckan-ui://datastore-table` serves self-contained HTML table viewer
+  - `ckan_datastore_search` now returns `_meta.ui.resourceUri` + `_meta.ui.data` for MCP Apps clients
+  - Interactive features: sortable columns (numeric/date/string type-aware), text filter, pagination (10/25/50/100 rows/page)
+  - Works in Node.js and Cloudflare Workers (HTML inlined in TypeScript module, no fs dependency)
+  - Non-breaking: text/markdown output unchanged; non-MCP-Apps clients ignore `_meta`
+  - Files: `src/ui/datastore-table.html`, `src/resources/datastore-table-ui.ts`, updated `src/tools/datastore.ts` and `src/resources/index.ts`
+  - Tests: 228 passing (7 new)
+  - Ideas: `docs/future-ideas.md` updated with MCP Apps section
+  - OpenSpec: `add-datastore-table-viewer` created and implemented
+
+## 2026-02-09
+
+### Feature Request - One-click Installation
+
+- Created issue #11 for one-click MCP server installation support
+- Proposes `claude://install-mcp-server` protocol integration
+- Based on Anthropic Desktop Extensions announcement
+- **Updated proposal**: Two one-click installers to serve different use cases
+  - 🚀 **"Try it now"** → HTTP Worker (instant, zero install, shared quota)
+  - 💪 **"Install locally"** → npx (unlimited, requires Node.js)
+- User journey: try demo first, install locally when ready for production
+- Files: GitHub issue #11 + comment
+
 ## 2026-02-02
 
 ### Release v0.4.39 - Local Install Promotion
@@ -17,7 +43,7 @@
 
 **Footer shown to Workers users**:
 ```
-ℹ️ Demo instance (100k requests/month shared globally). For unlimited access: https://github.com/ondata/ckan-mcp-server#installation
+ℹ️ Demo instance (100k requests/day shared quota). For unlimited access: https://github.com/ondata/ckan-mcp-server#installation
 ```
 
 **Files modified**:
@@ -478,10 +504,6 @@
 - **Fix**: Normalize natural-language queries before search
 - **Gemini**: Added API key input and NL→Solr query call
 
-### Web GUI landing + Pages deploy
-- **Web GUI**: Added static landing page in `web-gui/public`
-- **CI**: Added GitHub Pages workflow for auto deploy on HTML changes
-
 ## 2026-01-10
 
 ### Version 0.4.7 - Portal search parser override

package/README.md

@@ -24,19 +24,12 @@ MCP (Model Context Protocol) server for interacting with CKAN-based open data po
 
 ---
 
-> ## 🚀 **Recommended: Install Locally**
->
+> **💡 Local installation available** for unlimited access and better performance:
 > ```bash
 > npm install -g @aborruso/ckan-mcp-server
 > ```
 >
-> **Benefits:**
-> - ✅ **No request limits** - unlimited queries
-> - ✅ **Faster** - no network latency
-> - ✅ **Always available** - no shared quota
-> - ✅ **Free** - open source, no costs
->
-> The Cloudflare Workers endpoint is only for quick testing (100k requests/month shared globally across all users).
+> The Cloudflare Workers endpoint has 100k requests/day shared quota - sufficient for most users, but local installation is recommended for heavy usage.
 
 ---
 

package/dist/index.js

@@ -57,8 +57,8 @@ var portals_default = {
         "http://www.data.gov.uk"
       ],
       api_path: "/api/action",
-      dataset_view_url: "https://data.gov.uk/dataset/{name}",
-      organization_view_url: "https://data.gov.uk/publisher/{name}"
+      dataset_view_url: "https://www.data.gov.uk/dataset/{id}/{name}",
+      organization_view_url: "https://www.data.gov.uk/organization/{name}"
     },
     {
       id: "catalog-data-gov",
@@ -86,7 +86,9 @@ var portals_default = {
         "http://data.gov.au",
         "https://www.data.gov.au",
         "http://www.data.gov.au"
-      ]
+      ],
+      dataset_view_url: "https://data.gov.au/data/dataset/{name}",
+      organization_view_url: "https://data.gov.au/data/organization/{name}"
     },
     {
       id: "opendata-swiss",
@@ -98,6 +100,20 @@ var portals_default = {
         "https://www.opendata.swiss",
         "http://www.opendata.swiss"
       ]
+    },
+    {
+      id: "govdata-de",
+      name: "govdata.de",
+      api_url: "https://ckan.govdata.de",
+      api_url_aliases: [
+        "https://www.govdata.de",
+        "https://govdata.de",
+        "https://www.govdata.de/daten",
+        "https://data.gov.de",
+        "https://www.data.gov.de"
+      ],
+      dataset_view_url: "https://ckan.govdata.de/dataset/{name}",
+      organization_view_url: "https://ckan.govdata.de/organization/{name}"
     }
   ],
   defaults: {
@@ -412,6 +428,20 @@ function formatDate(dateStr) {
     return "Invalid Date";
   }
 }
+function isWorkers() {
+  try {
+    return typeof WorkerGlobalScope !== "undefined";
+  } catch {
+    return false;
+  }
+}
+function addDemoFooter(text) {
+  if (!isWorkers()) {
+    return text;
+  }
+  const footer = "\n\n---\n\u2139\uFE0F Demo instance (100k requests/day shared quota). For unlimited access: https://github.com/ondata/ckan-mcp-server#installation";
+  return text + footer;
+}
 
 // src/utils/url-generator.ts
 function getDatasetViewUrl(serverUrl, pkg) {
@@ -1008,7 +1038,7 @@ Note: showing top ${sorted.length} only. Use \`response_format: json\` for full
 `;
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -1186,7 +1216,7 @@ Examples:
           });
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -1257,7 +1287,7 @@ Examples:
         }
         const markdown = formatPackageShowMarkdown(result, params.server_url);
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -1409,7 +1439,7 @@ Note: organization_list returned 500; using package_search facets.
 `;
             }
             return {
-              content: [{ type: "text", text: truncateText(markdown2) }]
+              content: [{ type: "text", text: truncateText(addDemoFooter(markdown2)) }]
             };
           }
           throw error;
@@ -1454,7 +1484,7 @@ Note: organization_list returned 500; using package_search facets.
           }
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -1568,7 +1598,7 @@ ${result.description}
           markdown += "\n";
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -1672,7 +1702,7 @@ Examples:
           }
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -1810,7 +1840,19 @@ Examples:
 `;
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }],
+          _meta: {
+            ui: {
+              resourceUri: "ckan-ui://datastore-table",
+              data: {
+                server_url: params.server_url,
+                resource_id: params.resource_id,
+                total: result.total || 0,
+                fields: result.fields || [],
+                records: result.records || []
+              }
+            }
+          }
         };
       } catch (error) {
         return {
@@ -1914,7 +1956,7 @@ Examples:
           markdown += "No records returned by the SQL query.\n";
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -1971,7 +2013,7 @@ Returns:
 **Site URL**: ${result.site_url || "N/A"}
 `;
         return {
-          content: [{ type: "text", text: markdown }],
+          content: [{ type: "text", text: addDemoFooter(markdown) }],
           structuredContent: result
         };
       } catch (error) {
@@ -2106,7 +2148,7 @@ Returns:
           }
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -2267,7 +2309,7 @@ Returns:
           }
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -2368,7 +2410,7 @@ ${result.description}
           markdown += "\n";
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -2468,7 +2510,7 @@ Returns:
           }
         }
         return {
-          content: [{ type: "text", text: truncateText(markdown) }]
+          content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
       } catch (error) {
         return {
@@ -3130,7 +3172,7 @@ The MQA (Metadata Quality Assurance) system is operated by data.europa.eu and on
         return {
           content: [{
             type: "text",
-            text: output
+            text: addDemoFooter(output)
           }]
         };
       } catch (error) {
@@ -3170,7 +3212,7 @@ The MQA (Metadata Quality Assurance) system is operated by data.europa.eu and on
         return {
           content: [{
             type: "text",
-            text: output
+            text: addDemoFooter(output)
           }]
         };
       } catch (error) {
@@ -3443,6 +3485,329 @@ function registerFormatDatasetsResource(server2) {
   });
 }
 
+// src/resources/datastore-table-ui.ts
+import { ResourceTemplate as ResourceTemplate5 } from "@modelcontextprotocol/sdk/server/mcp.js";
+var DATASTORE_TABLE_HTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>DataStore Table Viewer</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: system-ui, -apple-system, sans-serif;
+      font-size: 13px;
+      background: #fff;
+      color: #1a1a1a;
+      padding: 12px;
+    }
+    .header {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      margin-bottom: 10px;
+      flex-wrap: wrap;
+    }
+    .title { font-size: 14px; font-weight: 600; color: #333; }
+    .badge {
+      font-size: 11px;
+      color: #555;
+      background: #f0f0f0;
+      border-radius: 10px;
+      padding: 2px 8px;
+    }
+    .controls {
+      display: flex;
+      gap: 8px;
+      margin-bottom: 10px;
+      align-items: center;
+      flex-wrap: wrap;
+    }
+    .filter-input {
+      flex: 1;
+      min-width: 140px;
+      max-width: 300px;
+      padding: 5px 10px;
+      border: 1px solid #d0d0d0;
+      border-radius: 4px;
+      font-size: 12px;
+      outline: none;
+    }
+    .filter-input:focus { border-color: #0066cc; }
+    .page-size-select {
+      padding: 5px 8px;
+      border: 1px solid #d0d0d0;
+      border-radius: 4px;
+      font-size: 12px;
+      background: #fff;
+    }
+    .count-info { font-size: 11px; color: #666; margin-left: auto; }
+    .table-wrapper {
+      overflow-x: auto;
+      border: 1px solid #e0e0e0;
+      border-radius: 4px;
+    }
+    table { width: 100%; border-collapse: collapse; font-size: 12px; }
+    th {
+      background: #f5f5f5;
+      padding: 7px 10px;
+      text-align: left;
+      font-weight: 600;
+      white-space: nowrap;
+      cursor: pointer;
+      user-select: none;
+      border-bottom: 2px solid #e0e0e0;
+    }
+    th:hover { background: #ebebeb; }
+    th.sort-asc::after { content: ' \\25B2'; font-size: 9px; color: #0066cc; }
+    th.sort-desc::after { content: ' \\25BC'; font-size: 9px; color: #0066cc; }
+    td {
+      padding: 5px 10px;
+      border-bottom: 1px solid #f0f0f0;
+      vertical-align: top;
+      max-width: 220px;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    tr:hover td { background: #fafafa; }
+    tr:last-child td { border-bottom: none; }
+    td.null-val { color: #bbb; font-style: italic; }
+    .pagination {
+      display: flex;
+      align-items: center;
+      gap: 3px;
+      margin-top: 10px;
+      flex-wrap: wrap;
+    }
+    .page-btn {
+      padding: 4px 9px;
+      border: 1px solid #d0d0d0;
+      border-radius: 3px;
+      background: #fff;
+      cursor: pointer;
+      font-size: 12px;
+      line-height: 1.4;
+    }
+    .page-btn:hover:not(:disabled) { background: #f0f0f0; }
+    .page-btn.active { background: #0066cc; color: #fff; border-color: #0066cc; }
+    .page-btn:disabled { opacity: 0.4; cursor: default; }
+    .ellipsis { padding: 4px 4px; font-size: 12px; color: #999; }
+    .notice {
+      font-size: 11px;
+      color: #888;
+      margin-top: 8px;
+      padding: 5px 10px;
+      background: #fafafa;
+      border-left: 3px solid #ddd;
+      border-radius: 0 3px 3px 0;
+    }
+    .state-msg { text-align: center; color: #aaa; padding: 40px 20px; font-size: 13px; }
+  </style>
+</head>
+<body>
+  <div id="app"><div class="state-msg">Waiting for data from MCP client&hellip;</div></div>
+  <script>
+  (function () {
+    var allRecords = [], fields = [], total = 0;
+    var filteredRecords = [], currentPage = 1, pageSize = 25;
+    var sortCol = null, sortDir = 1;
+    var filterText = '';
+    var colTypes = {};
+    function escHtml(s) {
+      return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+    }
+    function range(a, b) { var r=[]; for(var i=a;i<=b;i++) r.push(i); return r; }
+    function pagesToShow(cur, tot) {
+      if (tot<=7) return range(1,tot);
+      if (cur<=4) return range(1,5).concat([tot]);
+      if (cur>=tot-3) return [1].concat(range(tot-4,tot));
+      return [1,cur-1,cur,cur+1,tot];
+    }
+    var dateRe = /^\\d{4}-\\d{2}-\\d{2}/;
+    function inferType(samples) {
+      var numOk=0,dateOk=0,valid=0;
+      for(var i=0;i<samples.length;i++){
+        var v=samples[i];
+        if(v===null||v===undefined||v==='') continue;
+        valid++;
+        var s=String(v);
+        if(s!==''&&!isNaN(Number(s))) numOk++;
+        else if(dateRe.test(s)) dateOk++;
+      }
+      if(valid===0) return 'string';
+      if(numOk/valid>0.8) return 'number';
+      if(dateOk/valid>0.8) return 'date';
+      return 'string';
+    }
+    function detectColTypes(records,fieldList) {
+      var types={};
+      for(var i=0;i<fieldList.length;i++){
+        var fid=fieldList[i].id;
+        var samples=records.slice(0,20).map(function(r){return r[fid];});
+        types[fid]=inferType(samples);
+      }
+      return types;
+    }
+    function cmpValue(a,b,type){
+      if(a===null||a===undefined) return 1;
+      if(b===null||b===undefined) return -1;
+      if(type==='number') return Number(a)-Number(b);
+      if(type==='date') return new Date(a)-new Date(b);
+      return String(a).localeCompare(String(b));
+    }
+    function sortRecords(records){
+      if(!sortCol) return records;
+      var type=colTypes[sortCol]||'string';
+      return records.slice().sort(function(a,b){ return cmpValue(a[sortCol],b[sortCol],type)*sortDir; });
+    }
+    function applyFilter(records){
+      if(!filterText) return records;
+      var q=filterText.toLowerCase();
+      return records.filter(function(r){
+        return fields.some(function(f){
+          var v=r[f.id];
+          return v!==null&&v!==undefined&&String(v).toLowerCase().indexOf(q)!==-1;
+        });
+      });
+    }
+    function render(){
+      var app=document.getElementById('app');
+      filteredRecords=sortRecords(applyFilter(allRecords));
+      var totalFiltered=filteredRecords.length;
+      var totalPages=Math.ceil(totalFiltered/pageSize)||1;
+      if(currentPage>totalPages) currentPage=totalPages;
+      var start=(currentPage-1)*pageSize;
+      var pageRecords=filteredRecords.slice(start,start+pageSize);
+      var html='';
+      html+='<div class="header">';
+      html+='<span class="title">DataStore Table</span>';
+      html+='<span class="badge">'+total.toLocaleString()+' total on server</span>';
+      if(allRecords.length<total){
+        html+='<span class="badge" style="background:#fff3cd;color:#856404">batch: '+allRecords.length.toLocaleString()+'</span>';
+      }
+      html+='</div>';
+      var countLabel=(filterText&&totalFiltered<allRecords.length)
+        ?totalFiltered.toLocaleString()+' match'
+        :allRecords.length.toLocaleString()+' record'+(allRecords.length!==1?'s':'');
+      html+='<div class="controls">';
+      html+='<input class="filter-input" id="filter" type="text" placeholder="Filter all columns\\u2026" value="'+escHtml(filterText)+'">';
+      html+='<select class="page-size-select" id="pageSz">';
+      [10,25,50,100].forEach(function(n){
+        html+='<option value="'+n+'"'+(n===pageSize?' selected':'')+'>'+n+' rows</option>';
+      });
+      html+='</select>';
+      html+='<span class="count-info">'+countLabel+'</span></div>';
+      html+='<div class="table-wrapper"><table><thead><tr>';
+      fields.forEach(function(f){
+        var cls=(sortCol===f.id)?(sortDir===1?' class="sort-asc"':' class="sort-desc"'):'';
+        html+='<th'+cls+' data-col="'+escHtml(f.id)+'">'+escHtml(f.id)+'</th>';
+      });
+      html+='</tr></thead><tbody>';
+      if(pageRecords.length===0){
+        html+='<tr><td colspan="'+fields.length+'" class="state-msg">No records found</td></tr>';
+      } else {
+        pageRecords.forEach(function(rec){
+          html+='<tr>';
+          fields.forEach(function(f){
+            var v=rec[f.id];
+            if(v===null||v===undefined){
+              html+='<td class="null-val">\\u2014</td>';
+            } else {
+              var s=String(v);
+              var display=s.length>80?s.slice(0,77)+'\\u2026':s;
+              html+='<td title="'+escHtml(s)+'">'+escHtml(display)+'</td>';
+            }
+          });
+          html+='</tr>';
+        });
+      }
+      html+='</tbody></table></div>';
+      if(totalPages>1){
+        html+='<div class="pagination">';
+        html+='<button class="page-btn" id="prevBtn"'+(currentPage===1?' disabled':'')+'>\\u2039 Prev</button>';
+        var pages=pagesToShow(currentPage,totalPages);
+        var prev=null;
+        pages.forEach(function(p){
+          if(prev!==null&&p-prev>1) html+='<span class="ellipsis">\\u2026</span>';
+          html+='<button class="page-btn'+(p===currentPage?' active':'')+'" data-page="'+p+'">'+p+'</button>';
+          prev=p;
+        });
+        html+='<button class="page-btn" id="nextBtn"'+(currentPage===totalPages?' disabled':'')+'>Next \\u203a</button>';
+        html+='</div>';
+      }
+      if(total>allRecords.length){
+        html+='<div class="notice">Showing batch of '+allRecords.length.toLocaleString()+' records (server total: '+total.toLocaleString()+'). Re-run the tool with a different <code>offset</code> to access more records.</div>';
+      }
+      app.innerHTML=html;
+      bindEvents();
+    }
+    function bindEvents(){
+      var filterEl=document.getElementById('filter');
+      if(filterEl) filterEl.addEventListener('input',function(e){ filterText=e.target.value; currentPage=1; render(); });
+      var pageSzEl=document.getElementById('pageSz');
+      if(pageSzEl) pageSzEl.addEventListener('change',function(e){ pageSize=parseInt(e.target.value,10); currentPage=1; render(); });
+      document.querySelectorAll('th[data-col]').forEach(function(th){
+        th.addEventListener('click',function(){
+          var col=th.getAttribute('data-col');
+          if(sortCol===col){ sortDir=-sortDir; } else { sortCol=col; sortDir=1; }
+          render();
+        });
+      });
+      var p=document.getElementById('prevBtn');
+      if(p) p.addEventListener('click',function(){ currentPage--; render(); });
+      var n=document.getElementById('nextBtn');
+      if(n) n.addEventListener('click',function(){ currentPage++; render(); });
+      document.querySelectorAll('.page-btn[data-page]').forEach(function(btn){
+        btn.addEventListener('click',function(){ currentPage=parseInt(btn.getAttribute('data-page'),10); render(); });
+      });
+    }
+    function initTable(data){
+      fields=data.fields||[];
+      allRecords=data.records||[];
+      total=data.total||allRecords.length;
+      colTypes=detectColTypes(allRecords,fields);
+      currentPage=1; sortCol=null; sortDir=1; filterText='';
+      render();
+    }
+    window.addEventListener('message',function(event){
+      var msg=event.data;
+      if(!msg||typeof msg!=='object') return;
+      var data=
+        (msg._meta&&msg._meta.ui&&msg._meta.ui.data)||
+        (msg.toolResult&&msg.toolResult._meta&&msg.toolResult._meta.ui&&msg.toolResult._meta.ui.data)||
+        (msg.result&&msg.result._meta&&msg.result._meta.ui&&msg.result._meta.ui.data)||
+        (msg.fields&&msg.records?msg:null);
+      if(data&&(data.fields||data.records)) initTable(data);
+    });
+  }());
+  </script>
+</body>
+</html>`;
+function registerDatastoreTableUiResource(server2) {
+  server2.registerResource(
+    "ckan-datastore-table-ui",
+    new ResourceTemplate5("ckan-ui://datastore-table", { list: void 0 }),
+    {
+      title: "CKAN DataStore Table Viewer",
+      description: "Interactive sortable/filterable/paginated table for DataStore query results (MCP Apps UI)",
+      mimeType: "text/html"
+    },
+    async (uri) => {
+      return {
+        contents: [
+          {
+            uri: uri.href,
+            mimeType: "text/html",
+            text: DATASTORE_TABLE_HTML
+          }
+        ]
+      };
+    }
+  );
+}
+
 // src/resources/index.ts
 function registerAllResources(server2) {
   registerDatasetResource(server2);
@@ -3452,6 +3817,7 @@ function registerAllResources(server2) {
   registerOrganizationDatasetsResource(server2);
   registerTagDatasetsResource(server2);
   registerFormatDatasetsResource(server2);
+  registerDatastoreTableUiResource(server2);
 }
 
 // src/prompts/theme.ts
@@ -3725,7 +4091,7 @@ var registerAllPrompts = (server2) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.38"
+    version: "0.4.40"
   });
 }
 function registerAll(server2) {