@aborruso/ckan-mcp-server 0.4.5 → 0.4.7

package/EXAMPLES.md

@@ -20,6 +20,15 @@ ckan_package_search({
 })
 ```
 
+### Find relevant datasets
+```typescript
+ckan_find_relevant_datasets({
+  server_url: "https://demo.ckan.org",
+  query: "open data transport",
+  limit: 5
+})
+```
+
 ## Italy Examples - dati.gov.it
 
 ### Search recent datasets
@@ -41,6 +50,16 @@ ckan_package_search({
 })
 ```
 
+### Long OR query (force text-field parser)
+```typescript
+ckan_package_search({
+  server_url: "https://www.dati.gov.it/opendata",
+  q: "hotel OR alberghi OR \"strutture ricettive\" OR ospitalità OR ricettività OR agriturismo OR \"bed and breakfast\"",
+  query_parser: "text",
+  rows: 0
+})
+```
+
 ### Regione Siciliana datasets
 ```typescript
 ckan_package_search({

package/LOG.md

@@ -2,6 +2,19 @@
 
 ## 2026-01-10
 
+### Version 0.4.7 - Portal search parser override
+- **Config**: Added per-portal search parser config
+- **Tool**: Added query parser override for package search and relevance
+
+## 2026-01-10
+
+### Version 0.4.6 - Relevance ranking
+- **Tool**: Added `ckan_find_relevant_datasets`
+- **Docs**: Updated README/EXAMPLES
+- **Tests**: Added relevance scoring checks
+
+## 2026-01-10
+
 ### Version 0.4.5 - Health version
 - **Workers**: /health version/tools updated
 

package/README.md

@@ -40,27 +40,11 @@ npm run build
 npm test
 ```
 
-## Usage
-
-### Start with stdio (for local integration)
-
-```bash
-npm start
-```
-
-### Start with HTTP (for remote access)
-
-```bash
-TRANSPORT=http PORT=3000 npm start
-```
-
-The server will be available at `http://localhost:3000/mcp`
-
-## Deployment Options
+## Usage Options
 
 ### Option 1: Local Installation (stdio mode)
 
-**Best for**: Personal use with Claude Desktop
+**Best for**: Personal use with local MCP clients
 
 Install and run locally on your machine (see Installation section above).
 
@@ -92,7 +76,7 @@ Use the public Workers endpoint (no local install required):
 
 Want your own deployment? See [DEPLOYMENT.md](docs/DEPLOYMENT.md).
 
-## Claude Desktop Configuration
+### Claude Desktop Configuration
 
 Configuration file location:
 
@@ -100,7 +84,7 @@ Configuration file location:
 - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 - **Linux**: `~/.config/Claude/claude_desktop_config.json`
 
-### Option 1: Global Installation (Recommended)
+#### Option 1: Global Installation (Recommended)
 
 Install globally to use across all projects:
 
@@ -120,7 +104,7 @@ Then add to `claude_desktop_config.json`:
 }
 ```
 
-### Option 2: Local Installation (Optional)
+#### Option 2: Local Installation (Optional)
 
 If you installed locally (see Installation), use this config:
 
@@ -137,7 +121,7 @@ If you installed locally (see Installation), use this config:
 
 Replace `/absolute/path/to/project` with your actual project path.
 
-### Option 3: From Source
+#### Option 3: From Source
 
 If you cloned the repository:
 
@@ -152,7 +136,7 @@ If you cloned the repository:
 }
 ```
 
-### Option 4: Cloudflare Workers (HTTP transport)
+#### Option 4: Cloudflare Workers (HTTP transport)
 
 Use the public Cloudflare Workers deployment (no local installation required):
 
@@ -173,6 +157,7 @@ Use the public Cloudflare Workers deployment (no local installation required):
 ### Search and Discovery
 
 - **ckan_package_search**: Search datasets with Solr queries
+- **ckan_find_relevant_datasets**: Rank datasets by relevance score
 - **ckan_package_show**: Complete details of a dataset
 - **ckan_package_list**: List all datasets
 - **ckan_tag_list**: List tags with counts
@@ -225,6 +210,27 @@ ckan_package_search({
 })
 ```
 
+### Force text-field parser for long OR queries
+
+```typescript
+ckan_package_search({
+  server_url: "https://www.dati.gov.it/opendata",
+  q: "hotel OR alberghi OR \"strutture ricettive\" OR ospitalità OR ricettività",
+  query_parser: "text",
+  rows: 0
+})
+```
+
+### Rank datasets by relevance
+
+```typescript
+ckan_find_relevant_datasets({
+  server_url: "https://www.dati.gov.it/opendata",
+  query: "mobilità urbana",
+  limit: 5
+})
+```
+
 ### Filter by organization
 
 ```typescript
@@ -466,28 +472,32 @@ ckan_package_search({
 ```
 ckan-mcp-server/
 ├── src/
-│   ├── index.ts          # Entry point
-│   ├── server.ts         # MCP server setup
-│   ├── types.ts          # Types & schemas
+│   ├── index.ts            # Entry point
+│   ├── server.ts           # MCP server setup
+│   ├── worker.ts           # Cloudflare Workers entry
+│   ├── types.ts            # Types & schemas
 │   ├── utils/
-│   │   ├── http.ts       # CKAN API client
-│   │   └── formatting.ts # Output formatting
+│   │   ├── http.ts         # CKAN API client
+│   │   ├── formatting.ts   # Output formatting
+│   │   └── url-generator.ts
 │   ├── tools/
-│   │   ├── package.ts    # Package search/show
+│   │   ├── package.ts      # Package search/show
 │   │   ├── organization.ts # Organization tools
-│   │   ├── datastore.ts  # DataStore queries
-│   │   └── status.ts     # Server status
-│   ├── resources/        # MCP Resource Templates
+│   │   ├── datastore.ts    # DataStore queries
+│   │   ├── status.ts       # Server status
+│   │   ├── tag.ts          # Tag tools
+│   │   └── group.ts        # Group tools
+│   ├── resources/          # MCP Resource Templates
 │   │   ├── index.ts
-│   │   ├── uri.ts        # URI parsing
+│   │   ├── uri.ts          # URI parsing
 │   │   ├── dataset.ts
 │   │   ├── resource.ts
 │   │   └── organization.ts
 │   └── transport/
-│       ├── stdio.ts      # Stdio transport
-│       └── http.ts       # HTTP transport
-├── tests/                # Test suite (113 tests)
-├── dist/                 # Compiled files (generated)
+│       ├── stdio.ts        # Stdio transport
+│       └── http.ts         # HTTP transport
+├── tests/                  # Test suite (120 tests)
+├── dist/                   # Compiled files (generated)
 ├── package.json
 └── README.md
 ```