@ansvar/ch-farm-grants-mcp 0.1.0

package/server.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Ansvar-Systems/ch-farm-grants",
+  "description": "Swiss agricultural structural improvement grants: Investitionskredite, Beitraege, Meliorationen, PRE, eligibility, payment rates",
+  "repository": {
+    "url": "https://github.com/Ansvar-Systems/ch-farm-grants-mcp",
+    "source": "github"
+  },
+  "homepage": "https://ansvar.eu/open-agriculture",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "keywords": [
+    "swiss-agriculture",
+    "farm-grants",
+    "strukturverbesserungen",
+    "investitionskredit",
+    "svv",
+    "blw",
+    "switzerland",
+    "mcp"
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@ansvar/ch-farm-grants-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "identifier": "@ansvar/ch-farm-grants-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "streamable-http",
+        "url": "https://mcp.ansvar.eu/ch-farm-grants/mcp"
+      }
+    }
+  ]
+}

package/src/db.ts

@@ -0,0 +1,208 @@
+import BetterSqlite3 from 'better-sqlite3';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+export interface Database {
+  get<T>(sql: string, params?: unknown[]): T | undefined;
+  all<T>(sql: string, params?: unknown[]): T[];
+  run(sql: string, params?: unknown[]): void;
+  close(): void;
+  readonly instance: BetterSqlite3.Database;
+}
+
+export function createDatabase(dbPath?: string): Database {
+  const resolvedPath =
+    dbPath ??
+    join(dirname(fileURLToPath(import.meta.url)), '..', 'data', 'database.db');
+  const db = new BetterSqlite3(resolvedPath);
+
+  db.pragma('journal_mode = DELETE');
+  db.pragma('foreign_keys = ON');
+
+  initSchema(db);
+
+  return {
+    get<T>(sql: string, params: unknown[] = []): T | undefined {
+      return db.prepare(sql).get(...params) as T | undefined;
+    },
+    all<T>(sql: string, params: unknown[] = []): T[] {
+      return db.prepare(sql).all(...params) as T[];
+    },
+    run(sql: string, params: unknown[] = []): void {
+      db.prepare(sql).run(...params);
+    },
+    close(): void {
+      db.close();
+    },
+    get instance() {
+      return db;
+    },
+  };
+}
+
+function initSchema(db: BetterSqlite3.Database): void {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS grants (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      grant_type TEXT NOT NULL,
+      description TEXT,
+      federal_rate_pct REAL,
+      max_amount REAL,
+      duration_years INTEGER,
+      zone_bonus TEXT,
+      legal_basis TEXT,
+      language TEXT DEFAULT 'DE',
+      jurisdiction TEXT NOT NULL DEFAULT 'CH'
+    );
+
+    CREATE TABLE IF NOT EXISTS grant_options (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      grant_id TEXT NOT NULL REFERENCES grants(id),
+      option_name TEXT NOT NULL,
+      description TEXT,
+      rate TEXT,
+      conditions TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS eligibility_rules (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      grant_id TEXT NOT NULL REFERENCES grants(id),
+      farm_type TEXT,
+      investment_type TEXT,
+      zone TEXT,
+      requirement TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS application_deadlines (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      grant_id TEXT NOT NULL REFERENCES grants(id),
+      canton TEXT,
+      deadline_date TEXT,
+      notes TEXT
+    );
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS search_index USING fts5(
+      title, body, grant_type, jurisdiction
+    );
+
+    CREATE TABLE IF NOT EXISTS db_metadata (
+      key TEXT PRIMARY KEY,
+      value TEXT
+    );
+
+    INSERT OR IGNORE INTO db_metadata (key, value) VALUES ('schema_version', '1.0');
+    INSERT OR IGNORE INTO db_metadata (key, value) VALUES ('mcp_name', 'Switzerland Farm Grants MCP');
+    INSERT OR IGNORE INTO db_metadata (key, value) VALUES ('jurisdiction', 'CH');
+  `);
+}
+
+const FTS_COLUMNS = ['title', 'body', 'grant_type', 'jurisdiction'];
+
+export function ftsSearch(
+  db: Database,
+  query: string,
+  limit: number = 20
+): { title: string; body: string; grant_type: string; jurisdiction: string; rank: number }[] {
+  const { results } = tieredFtsSearch(db, 'search_index', FTS_COLUMNS, query, limit);
+  return results as { title: string; body: string; grant_type: string; jurisdiction: string; rank: number }[];
+}
+
+/**
+ * Tiered FTS5 search with automatic fallback.
+ * Tiers: exact phrase -> AND -> prefix -> stemmed prefix -> OR -> LIKE
+ */
+export function tieredFtsSearch(
+  db: Database,
+  table: string,
+  columns: string[],
+  query: string,
+  limit: number = 20
+): { tier: string; results: Record<string, unknown>[] } {
+  const sanitized = sanitizeFtsInput(query);
+  if (!sanitized.trim()) return { tier: 'empty', results: [] };
+
+  const columnList = columns.join(', ');
+  const select = `SELECT ${columnList}, rank FROM ${table}`;
+  const order = `ORDER BY rank LIMIT ?`;
+
+  // Tier 1: Exact phrase
+  const phrase = `"${sanitized}"`;
+  let results = tryFts(db, select, table, order, phrase, limit);
+  if (results.length > 0) return { tier: 'phrase', results };
+
+  // Tier 2: AND
+  const words = sanitized.split(/\s+/).filter(w => w.length > 1);
+  if (words.length > 1) {
+    const andQuery = words.join(' AND ');
+    results = tryFts(db, select, table, order, andQuery, limit);
+    if (results.length > 0) return { tier: 'and', results };
+  }
+
+  // Tier 3: Prefix
+  const prefixQuery = words.map(w => `${w}*`).join(' AND ');
+  results = tryFts(db, select, table, order, prefixQuery, limit);
+  if (results.length > 0) return { tier: 'prefix', results };
+
+  // Tier 4: Stemmed prefix
+  const stemmed = words.map(w => stemWord(w) + '*');
+  const stemmedQuery = stemmed.join(' AND ');
+  if (stemmedQuery !== prefixQuery) {
+    results = tryFts(db, select, table, order, stemmedQuery, limit);
+    if (results.length > 0) return { tier: 'stemmed', results };
+  }
+
+  // Tier 5: OR
+  if (words.length > 1) {
+    const orQuery = words.join(' OR ');
+    results = tryFts(db, select, table, order, orQuery, limit);
+    if (results.length > 0) return { tier: 'or', results };
+  }
+
+  // Tier 6: LIKE fallback
+  const baseCols = ['name', 'grant_type'];
+  const likeConditions = words.map(() =>
+    `(${baseCols.map(c => `${c} LIKE ?`).join(' OR ')})`
+  ).join(' AND ');
+  const likeParams = words.flatMap(w =>
+    baseCols.map(() => `%${w}%`)
+  );
+  try {
+    const likeResults = db.all<Record<string, unknown>>(
+      `SELECT name as title, COALESCE(description, '') as body, grant_type, jurisdiction FROM grants WHERE ${likeConditions} LIMIT ?`,
+      [...likeParams, limit]
+    );
+    if (likeResults.length > 0) return { tier: 'like', results: likeResults };
+  } catch {
+    // LIKE fallback failed
+  }
+
+  return { tier: 'none', results: [] };
+}
+
+function tryFts(
+  db: Database, select: string, table: string,
+  order: string, matchExpr: string, limit: number
+): Record<string, unknown>[] {
+  try {
+    return db.all(
+      `${select} WHERE ${table} MATCH ? ${order}`,
+      [matchExpr, limit]
+    );
+  } catch {
+    return [];
+  }
+}
+
+function sanitizeFtsInput(query: string): string {
+  return query
+    .replace(/["""'',,,,]/g, '"')
+    .replace(/[^a-zA-Z0-9\s*"_\u00C0-\u024F-]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function stemWord(word: string): string {
+  return word
+    .replace(/(ung|heit|keit|lich|isch|ieren|tion|ment|ness|able|ible|ous|ive|ing|ers|ed|es|er|en|ly|s)$/i, '');
+}

package/src/http-server.ts

@@ -0,0 +1,293 @@
+import { createServer, type IncomingMessage, type ServerResponse } from 'http';
+import { randomUUID } from 'crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { createDatabase, type Database } from './db.js';
+import { handleAbout } from './tools/about.js';
+import { handleListSources } from './tools/list-sources.js';
+import { handleCheckFreshness } from './tools/check-freshness.js';
+import { handleSearchGrants } from './tools/search-grants.js';
+import { handleGetGrantDetails } from './tools/get-grant-details.js';
+import { handleGetPaymentRates } from './tools/get-payment-rates.js';
+import { handleCheckEligibility } from './tools/check-eligibility.js';
+import { handleListGrantOptions } from './tools/list-grant-options.js';
+import { handleGetApplicationDeadlines } from './tools/get-application-deadlines.js';
+import { handleSearchApplicationGuidance } from './tools/search-application-guidance.js';
+
+const SERVER_NAME = 'ch-farm-grants-mcp';
+const SERVER_VERSION = '0.1.0';
+const PORT = parseInt(process.env.PORT ?? '3000', 10);
+
+const SearchGrantsArgsSchema = z.object({
+  query: z.string(),
+  grant_type: z.string().optional(),
+  jurisdiction: z.string().optional(),
+  limit: z.number().optional(),
+});
+
+const GrantDetailsArgsSchema = z.object({
+  grant_id: z.string(),
+  jurisdiction: z.string().optional(),
+});
+
+const PaymentRatesArgsSchema = z.object({
+  grant_id: z.string(),
+  zone: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const EligibilityArgsSchema = z.object({
+  farm_type: z.string(),
+  investment_type: z.string().optional(),
+  zone: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const ListGrantOptionsArgsSchema = z.object({
+  grant_id: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const DeadlinesArgsSchema = z.object({
+  grant_id: z.string().optional(),
+  canton: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const GuidanceArgsSchema = z.object({
+  query: z.string(),
+  jurisdiction: z.string().optional(),
+});
+
+const TOOLS = [
+  {
+    name: 'about',
+    description: 'Get server metadata: name, version, coverage, data sources, and links.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'list_sources',
+    description: 'List all data sources with authority, URL, license, and freshness info.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'check_data_freshness',
+    description: 'Check when data was last ingested, staleness status, and how to trigger a refresh.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'search_grants',
+    description: 'Search Swiss agricultural structural improvement grants, investment credits, and funding programmes. Use for broad queries about Investitionskredite, Beitraege, Meliorationen, PRE.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        query: { type: 'string', description: 'Free-text search query (German or English)' },
+        grant_type: { type: 'string', description: 'Filter by type: investitionskredit, beitrag, meliorationsbeitrag, pre, ressourcenprogramm, gewaesserschutz, starthilfe' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+        limit: { type: 'number', description: 'Max results (default: 20, max: 50)' },
+      },
+      required: ['query'],
+    },
+  },
+  {
+    name: 'get_grant_details',
+    description: 'Get full details for a specific grant programme: objectives, contribution rates, conditions, eligibility rules, and sub-options.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        grant_id: { type: 'string', description: 'Grant ID or name (e.g. investitionskredit-oekonomiegebaeude, starthilfe-junglandwirte)' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+      required: ['grant_id'],
+    },
+  },
+  {
+    name: 'get_payment_rates',
+    description: 'Get federal and cantonal contribution rates for a grant programme, with zone-specific bonuses (Berggebiet, Huegelzone).',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        grant_id: { type: 'string', description: 'Grant ID or name' },
+        zone: { type: 'string', description: 'Altitude zone: talzone, huegelzone, bergzone_i-iv, soemmerungsgebiet' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+      required: ['grant_id'],
+    },
+  },
+  {
+    name: 'check_eligibility',
+    description: 'Check which grants a farm is eligible for based on farm type, planned investment, and altitude zone.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        farm_type: { type: 'string', description: 'Farm type: milchwirtschaft, ackerbau, mutterkuhhaltung, bergbetrieb, alpwirtschaft, gemischt, gemeinschaft, junglandwirt' },
+        investment_type: { type: 'string', description: 'Investment type: stallbau, hofduengerlager, wohnhaus, diversifikation, alpgebaeude, wegebau, wasserversorgung, biogasanlage, kaeserei' },
+        zone: { type: 'string', description: 'Altitude zone: talzone, huegelzone, bergzone_i-iv, soemmerungsgebiet' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+      required: ['farm_type'],
+    },
+  },
+  {
+    name: 'list_grant_options',
+    description: 'List all sub-options (Massnahmen) within a grant programme, or list all grants with their option counts.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        grant_id: { type: 'string', description: 'Grant ID to list options for. If omitted, lists all grants.' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+    },
+  },
+  {
+    name: 'get_application_deadlines',
+    description: 'Get application deadlines for grants, optionally filtered by canton (2-letter code: ZH, BE, LU, etc.).',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        grant_id: { type: 'string', description: 'Grant ID to check deadlines for' },
+        canton: { type: 'string', description: 'Canton code (e.g. ZH, BE, LU, SG, GR, VS, TI)' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+    },
+  },
+  {
+    name: 'search_application_guidance',
+    description: 'How to apply for Swiss farm grants: required documents, cantonal contacts, general process, and AGRIDEA advisory support.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        query: { type: 'string', description: 'Free-text search query about the application process' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+      required: ['query'],
+    },
+  },
+];
+
+function textResult(data: unknown) {
+  return { content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }] };
+}
+
+function errorResult(message: string) {
+  return { content: [{ type: 'text' as const, text: JSON.stringify({ error: message }) }], isError: true };
+}
+
+function registerTools(server: Server, db: Database): void {
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+
+    try {
+      switch (name) {
+        case 'about':
+          return textResult(handleAbout());
+        case 'list_sources':
+          return textResult(handleListSources(db));
+        case 'check_data_freshness':
+          return textResult(handleCheckFreshness(db));
+        case 'search_grants':
+          return textResult(handleSearchGrants(db, SearchGrantsArgsSchema.parse(args)));
+        case 'get_grant_details':
+          return textResult(handleGetGrantDetails(db, GrantDetailsArgsSchema.parse(args)));
+        case 'get_payment_rates':
+          return textResult(handleGetPaymentRates(db, PaymentRatesArgsSchema.parse(args)));
+        case 'check_eligibility':
+          return textResult(handleCheckEligibility(db, EligibilityArgsSchema.parse(args)));
+        case 'list_grant_options':
+          return textResult(handleListGrantOptions(db, ListGrantOptionsArgsSchema.parse(args)));
+        case 'get_application_deadlines':
+          return textResult(handleGetApplicationDeadlines(db, DeadlinesArgsSchema.parse(args)));
+        case 'search_application_guidance':
+          return textResult(handleSearchApplicationGuidance(db, GuidanceArgsSchema.parse(args)));
+        default:
+          return errorResult(`Unknown tool: ${name}`);
+      }
+    } catch (err) {
+      return errorResult(err instanceof Error ? err.message : String(err));
+    }
+  });
+}
+
+const db = createDatabase();
+const sessions = new Map<string, { transport: StreamableHTTPServerTransport; server: Server }>();
+
+function createMcpServer(): Server {
+  const mcpServer = new Server(
+    { name: SERVER_NAME, version: SERVER_VERSION },
+    { capabilities: { tools: {} } }
+  );
+  registerTools(mcpServer, db);
+  return mcpServer;
+}
+
+async function handleMCPRequest(req: IncomingMessage, res: ServerResponse): Promise<void> {
+  const sessionId = req.headers['mcp-session-id'] as string | undefined;
+
+  if (sessionId && sessions.has(sessionId)) {
+    const session = sessions.get(sessionId)!;
+    await session.transport.handleRequest(req, res);
+    return;
+  }
+
+  if (req.method === 'GET' || req.method === 'DELETE') {
+    res.writeHead(400, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: 'Invalid or missing session ID' }));
+    return;
+  }
+
+  const mcpServer = createMcpServer();
+  const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: () => randomUUID(),
+  });
+
+  await mcpServer.connect(transport);
+
+  transport.onclose = () => {
+    if (transport.sessionId) {
+      sessions.delete(transport.sessionId);
+    }
+    mcpServer.close().catch(() => {});
+  };
+
+  await transport.handleRequest(req, res);
+
+  if (transport.sessionId) {
+    sessions.set(transport.sessionId, { transport, server: mcpServer });
+  }
+}
+
+const httpServer = createServer(async (req, res) => {
+  const url = new URL(req.url || '/', `http://localhost:${PORT}`);
+
+  if (url.pathname === '/health' && req.method === 'GET') {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ status: 'healthy', server: SERVER_NAME, version: SERVER_VERSION }));
+    return;
+  }
+
+  if (url.pathname === '/mcp' || url.pathname === '/') {
+    try {
+      await handleMCPRequest(req, res);
+    } catch (err) {
+      if (!res.headersSent) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: err instanceof Error ? err.message : 'Internal server error' }));
+      }
+    }
+    return;
+  }
+
+  res.writeHead(404, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify({ error: 'Not found' }));
+});
+
+httpServer.listen(PORT, () => {
+  console.log(`${SERVER_NAME} v${SERVER_VERSION} listening on port ${PORT}`);
+});

package/src/jurisdiction.ts

@@ -0,0 +1,30 @@
+export const SUPPORTED_JURISDICTIONS = ['CH'] as const;
+export type Jurisdiction = (typeof SUPPORTED_JURISDICTIONS)[number];
+
+type ValidationSuccess = { valid: true; jurisdiction: Jurisdiction };
+type ValidationFailure = {
+  valid: false;
+  error: {
+    error: string;
+    supported: readonly string[];
+    message: string;
+  };
+};
+type ValidationResult = ValidationSuccess | ValidationFailure;
+
+export function validateJurisdiction(input: string | undefined): ValidationResult {
+  const normalised = (input ?? 'CH').toUpperCase();
+
+  if (SUPPORTED_JURISDICTIONS.includes(normalised as Jurisdiction)) {
+    return { valid: true, jurisdiction: normalised as Jurisdiction };
+  }
+
+  return {
+    valid: false,
+    error: {
+      error: 'jurisdiction_not_supported',
+      supported: SUPPORTED_JURISDICTIONS,
+      message: 'This server currently covers Switzerland. More jurisdictions are planned.',
+    },
+  };
+}

package/src/metadata.ts

@@ -0,0 +1,32 @@
+export interface Meta {
+  disclaimer: string;
+  data_age: string;
+  source_url: string;
+  copyright: string;
+  server: string;
+  version: string;
+}
+
+const DISCLAIMER =
+  'Diese Daten dienen ausschliesslich der Information und stellen keine Zusicherung fuer die Gewaehrung ' +
+  'von Foerdermitteln dar. Foerderentscheide liegen bei den zustaendigen kantonalen Landwirtschaftsaemtern ' +
+  'und dem Bundesamt fuer Landwirtschaft (BLW). Vor der Einreichung eines Gesuchs ist stets die kantonale ' +
+  'Fachstelle oder AGRIDEA zu konsultieren. Die Daten basieren auf der Strukturverbesserungsverordnung ' +
+  '(SVV, SR 913.1), den BLW-Weisungen zu Investitionskrediten und Beitraegen, sowie kantonalen ' +
+  'Ausfuehrungsbestimmungen. Kantonale Beitragssaetze und Fristen koennen abweichen. / ' +
+  'This data is provided for informational purposes only and does not guarantee grant approval. ' +
+  'Funding decisions are made by cantonal agricultural offices and the Federal Office for Agriculture (BLW). ' +
+  'Always consult the relevant cantonal authority before submitting an application. Data sourced from ' +
+  'SVV (SR 913.1), BLW investment credit guidelines, and cantonal implementation rules.';
+
+export function buildMeta(overrides?: Partial<Meta>): Meta {
+  return {
+    disclaimer: DISCLAIMER,
+    data_age: overrides?.data_age ?? 'unknown',
+    source_url: overrides?.source_url ?? 'https://www.blw.admin.ch/blw/de/home/instrumente/strukturverbesserungen.html',
+    copyright: 'Data: BLW, SVV, AGRIDEA, kantonale Landwirtschaftsaemter — used under public-sector information principles. Server: Apache-2.0 Ansvar Systems.',
+    server: 'ch-farm-grants-mcp',
+    version: '0.1.0',
+    ...overrides,
+  };
+}