@aborruso/ckan-mcp-server 0.4.7 → 0.4.8

package/README.md

@@ -74,6 +74,8 @@ Use the public Workers endpoint (no local install required):
 }
 ```
 
+**NOTE**: This service uses the Cloudflare Workers free tier which has a limit of 100,000 requests per month.
+
 Want your own deployment? See [DEPLOYMENT.md](docs/DEPLOYMENT.md).
 
 ### Claude Desktop Configuration
@@ -150,6 +152,8 @@ Use the public Cloudflare Workers deployment (no local installation required):
 }
 ```
 
+**NOTE**: This service uses the Cloudflare Workers free tier which has a limit of 100,000 requests per month.
+
 **Note**: This uses the public endpoint. You can also deploy your own Workers instance and use that URL instead.
 
 ## Available Tools

package/dist/index.js

@@ -411,6 +411,15 @@ ${params.fq ? `**Filter**: ${params.fq}
             const sorted = Object.entries(facetValues).sort((a, b) => b[1] - a[1]).slice(0, 10);
             for (const [value, count] of sorted) {
               markdown += `- **${value}**: ${count}
+`;
+            }
+            if (Object.keys(facetValues).length > sorted.length) {
+              markdown += `
+Note: showing top ${sorted.length} only. Use \`response_format: json\` or increase \`facet_limit\`.
+`;
+            } else {
+              markdown += `
+Note: showing top ${sorted.length} only. Use \`response_format: json\` for full list.
 `;
             }
             markdown += "\n";
@@ -897,16 +906,84 @@ Returns:
             content: [{ type: "text", text: markdown2 }]
           };
         }
-        const result = await makeCkanRequest(
-          params.server_url,
-          "organization_list",
-          {
-            all_fields: params.all_fields,
-            sort: params.sort,
-            limit: params.limit,
-            offset: params.offset
+        let result;
+        try {
+          result = await makeCkanRequest(
+            params.server_url,
+            "organization_list",
+            {
+              all_fields: params.all_fields,
+              sort: params.sort,
+              limit: params.limit,
+              offset: params.offset
+            }
+          );
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          if (message.includes("CKAN API error (500)")) {
+            const searchResult = await makeCkanRequest(
+              params.server_url,
+              "package_search",
+              {
+                rows: 0,
+                "facet.field": JSON.stringify(["organization"]),
+                "facet.limit": -1
+              }
+            );
+            const items = searchResult.search_facets?.organization?.items || [];
+            const sortValue = params.sort?.toLowerCase() ?? "name asc";
+            const sortedItems = [...items].sort((a, b) => {
+              if (sortValue.includes("package_count") || sortValue.includes("count")) {
+                return b.count - a.count;
+              }
+              if (sortValue.includes("name desc")) {
+                return String(b.name).localeCompare(String(a.name));
+              }
+              return String(a.name).localeCompare(String(b.name));
+            });
+            const pagedItems = sortedItems.slice(params.offset, params.offset + params.limit);
+            const organizations = pagedItems.map((item) => ({
+              id: item.name,
+              name: item.name,
+              title: item.display_name || item.name,
+              package_count: item.count
+            }));
+            if (params.response_format === "json" /* JSON */) {
+              const output = { count: items.length, organizations };
+              return {
+                content: [{ type: "text", text: truncateText(JSON.stringify(output, null, 2)) }],
+                structuredContent: output
+              };
+            }
+            let markdown2 = `# CKAN Organizations
+
+`;
+            markdown2 += `**Server**: ${params.server_url}
+`;
+            markdown2 += `**Total**: ${items.length}
+`;
+            markdown2 += `
+Note: organization_list returned 500; using package_search facets.
+
+`;
+            for (const org of organizations) {
+              markdown2 += `## ${org.title || org.name}
+
+`;
+              markdown2 += `- **Name**: \`${org.name}\`
+`;
+              markdown2 += `- **Datasets**: ${org.package_count || 0}
+`;
+              markdown2 += `- **Link**: ${getOrganizationViewUrl(params.server_url, org)}
+
+`;
+            }
+            return {
+              content: [{ type: "text", text: truncateText(markdown2) }]
+            };
           }
-        );
+          throw error;
+        }
         if (params.response_format === "json" /* JSON */) {
           const output = Array.isArray(result) ? { count: result.length, organizations: result } : result;
           return {
@@ -2149,7 +2226,7 @@ function registerAllResources(server2) {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.7"
+    version: "0.4.8"
   });
 }
 function registerAll(server2) {