@aborruso/ckan-mcp-server 0.4.9 → 0.4.11

package/dist/index.js

@@ -2222,11 +2222,247 @@ function registerAllResources(server2) {
   registerOrganizationResource(server2);
 }
 
+// src/prompts/theme.ts
+import { z as z8 } from "zod";
+
+// src/prompts/types.ts
+var createTextPrompt = (text) => ({
+  messages: [
+    {
+      role: "user",
+      content: {
+        type: "text",
+        text
+      }
+    }
+  ]
+});
+
+// src/prompts/theme.ts
+var THEME_PROMPT_NAME = "ckan-search-by-theme";
+var buildThemePromptText = (serverUrl, theme, rows) => `# Guided search: datasets by theme
+
+## Step 1: Find the theme/group
+Use \`ckan_group_search\` to locate the group that matches the theme.
+
+Example:
+
+ckan_group_search({
+  server_url: "${serverUrl}",
+  pattern: "${theme}"
+})
+
+## Step 2: Search datasets in that group
+Use \`ckan_package_search\` with a group filter.
+
+Example:
+
+ckan_package_search({
+  server_url: "${serverUrl}",
+  fq: "groups:<group_name>",
+  sort: "metadata_modified desc",
+  rows: ${rows}
+})
+
+## If no group matches
+Fallback to a tag-based search using facets:
+
+ckan_package_search({
+  server_url: "${serverUrl}",
+  q: "tags:${theme}",
+  sort: "metadata_modified desc",
+  rows: ${rows}
+})`;
+var registerThemePrompt = (server2) => {
+  server2.registerPrompt(
+    THEME_PROMPT_NAME,
+    {
+      title: "Search datasets by theme",
+      description: "Guided prompt to discover a theme and search datasets under it.",
+      argsSchema: {
+        server_url: z8.string().url().describe("Base URL of the CKAN server"),
+        theme: z8.string().min(1).describe("Theme or group name to search"),
+        rows: z8.coerce.number().int().positive().default(10).describe("Max results to return")
+      }
+    },
+    async ({ server_url, theme, rows }) => createTextPrompt(buildThemePromptText(server_url, theme, rows))
+  );
+};
+
+// src/prompts/organization.ts
+import { z as z9 } from "zod";
+var ORGANIZATION_PROMPT_NAME = "ckan-search-by-organization";
+var buildOrganizationPromptText = (serverUrl, organization, rows) => `# Guided search: datasets by organization
+
+## Step 1: Discover matching organizations
+Use \`ckan_package_search\` with an organization wildcard and facets:
+
+ckan_package_search({
+  server_url: "${serverUrl}",
+  q: "organization:*${organization}*",
+  rows: 0,
+  facet_field: ["organization"],
+  facet_limit: 50
+})
+
+## Step 2: Search datasets for the chosen organization
+Use \`ckan_package_search\` with a filter query:
+
+ckan_package_search({
+  server_url: "${serverUrl}",
+  fq: "organization:<org-id>",
+  sort: "metadata_modified desc",
+  rows: ${rows}
+})`;
+var registerOrganizationPrompt = (server2) => {
+  server2.registerPrompt(
+    ORGANIZATION_PROMPT_NAME,
+    {
+      title: "Search datasets by organization",
+      description: "Guided prompt to find a publisher and list its datasets.",
+      argsSchema: {
+        server_url: z9.string().url().describe("Base URL of the CKAN server"),
+        organization: z9.string().min(1).describe("Organization name or keyword"),
+        rows: z9.coerce.number().int().positive().default(10).describe("Max results to return")
+      }
+    },
+    async ({ server_url, organization, rows }) => createTextPrompt(buildOrganizationPromptText(server_url, organization, rows))
+  );
+};
+
+// src/prompts/format.ts
+import { z as z10 } from "zod";
+var FORMAT_PROMPT_NAME = "ckan-search-by-format";
+var buildFormatPromptText = (serverUrl, format, rows) => `# Guided search: datasets by resource format
+
+Use \`ckan_package_search\` with a format filter:
+
+ckan_package_search({
+  server_url: "${serverUrl}",
+  fq: "res_format:${format}",
+  sort: "metadata_modified desc",
+  rows: ${rows}
+})
+
+Tip: try uppercase (CSV/JSON) or common variants if results are sparse.`;
+var registerFormatPrompt = (server2) => {
+  server2.registerPrompt(
+    FORMAT_PROMPT_NAME,
+    {
+      title: "Search datasets by resource format",
+      description: "Guided prompt to find datasets with a given resource format.",
+      argsSchema: {
+        server_url: z10.string().url().describe("Base URL of the CKAN server"),
+        format: z10.string().min(1).describe("Resource format (e.g., CSV, JSON)"),
+        rows: z10.coerce.number().int().positive().default(10).describe("Max results to return")
+      }
+    },
+    async ({ server_url, format, rows }) => createTextPrompt(buildFormatPromptText(server_url, format, rows))
+  );
+};
+
+// src/prompts/recent.ts
+import { z as z11 } from "zod";
+var RECENT_PROMPT_NAME = "ckan-recent-datasets";
+var buildRecentPromptText = (serverUrl, rows) => `# Guided search: recent datasets
+
+Use \`ckan_package_search\` sorted by modification date:
+
+ckan_package_search({
+  server_url: "${serverUrl}",
+  q: "*:*",
+  sort: "metadata_modified desc",
+  rows: ${rows}
+})
+
+Optional: add a date filter for the last N days:
+
+ckan_package_search({
+  server_url: "${serverUrl}",
+  q: "metadata_modified:[NOW-30DAYS TO *]",
+  sort: "metadata_modified desc",
+  rows: ${rows}
+})`;
+var registerRecentPrompt = (server2) => {
+  server2.registerPrompt(
+    RECENT_PROMPT_NAME,
+    {
+      title: "Find recently updated datasets",
+      description: "Guided prompt to list recently updated datasets on a CKAN portal.",
+      argsSchema: {
+        server_url: z11.string().url().describe("Base URL of the CKAN server"),
+        rows: z11.coerce.number().int().positive().default(10).describe("Max results to return")
+      }
+    },
+    async ({ server_url, rows }) => createTextPrompt(buildRecentPromptText(server_url, rows))
+  );
+};
+
+// src/prompts/dataset-analysis.ts
+import { z as z12 } from "zod";
+var DATASET_ANALYSIS_PROMPT_NAME = "ckan-analyze-dataset";
+var buildDatasetAnalysisPromptText = (serverUrl, id) => `# Guided analysis: dataset
+
+## Step 1: Get dataset metadata
+Use \`ckan_package_show\` to load full metadata and resources:
+
+ckan_package_show({
+  server_url: "${serverUrl}",
+  id: "${id}"
+})
+
+## Step 2: Inspect resources
+For each resource, use \`ckan_resource_show\` to confirm fields like format, url, and datastore availability:
+
+ckan_resource_show({
+  server_url: "${serverUrl}",
+  id: "<resource-id>"
+})
+
+## Step 3: Explore DataStore (if available)
+If a resource has \`datastore_active=true\`, use:
+
+ckan_datastore_search({
+  server_url: "${serverUrl}",
+  resource_id: "<resource-id>",
+  limit: 10
+})
+
+For aggregates, use SQL:
+
+ckan_datastore_search_sql({
+  server_url: "${serverUrl}",
+  sql: "SELECT * FROM "<resource-id>" LIMIT 10"
+})`;
+var registerDatasetAnalysisPrompt = (server2) => {
+  server2.registerPrompt(
+    DATASET_ANALYSIS_PROMPT_NAME,
+    {
+      title: "Analyze a dataset",
+      description: "Guided prompt to inspect dataset metadata and explore DataStore tables.",
+      argsSchema: {
+        server_url: z12.string().url().describe("Base URL of the CKAN server"),
+        id: z12.string().min(1).describe("Dataset id or name (CKAN package id)")
+      }
+    },
+    async ({ server_url, id }) => createTextPrompt(buildDatasetAnalysisPromptText(server_url, id))
+  );
+};
+
+// src/prompts/index.ts
+var registerAllPrompts = (server2) => {
+  registerThemePrompt(server2);
+  registerOrganizationPrompt(server2);
+  registerFormatPrompt(server2);
+  registerRecentPrompt(server2);
+  registerDatasetAnalysisPrompt(server2);
+};
+
 // src/server.ts
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.8"
+    version: "0.4.11"
   });
 }
 function registerAll(server2) {
@@ -2237,6 +2473,7 @@ function registerAll(server2) {
   registerTagTools(server2);
   registerGroupTools(server2);
   registerAllResources(server2);
+  registerAllPrompts(server2);
 }
 
 // src/transport/stdio.ts