@quotelijst/mcp-server

Een Model Context Protocol (MCP) server die de volledige Quotelijst API beschikbaar maakt als tools voor AI-assistenten. De server kan als (private) npm package gepubliceerd worden en stelt iedere beschikbare Quotelijst endpoint ter beschikking via MCP tools.

Installatie

npm install @quotelijst/mcp-server

Omdat dit pakket als private is gemarkeerd moet het via een privé npm registry of via npm install <tarball> gedeployed worden.

Gebruik

Start de server rechtstreeks vanuit Node.js:

npx quotelijst-mcp-server

Of importeer de helper in een eigen Node-applicatie:

import { createServer, start } from '@quotelijst/mcp-server';

const server = createServer({
  baseUrl: 'https://api.quotelijst.nl',
});

await server.start();

Standaard wordt https://api.quotelijst.nl gebruikt als basis-URL. Stel de omgevingsvariabele QUOTELIJST_API_BASE_URL in om de server naar een andere omgeving te laten wijzen (bijvoorbeeld een stagingomgeving).

Tools

Elke Quotelijst API-route is als individuele MCP tool beschikbaar. Elke toolnaam is opgebouwd uit het HTTP-method en het pad van de originele API (bijvoorbeeld getJsonParamCompanyQuote voor GET /json/{company}/quote). De tool input ondersteunt:

• padparameters die overeenkomen met de placeholders in de API route,
• optionele query-parameters (query object),

Elke tool retourneert twee items:

1. JSON metadata met HTTP status, headers, methode en URL die is aangeroepen.
2. De daadwerkelijke API-respons als JSON (indien de server JSON retourneert) of als tekst.

Ontwikkeling

Het pakket is gebouwd met ECMAScript modules en gebruikt de officiële @modelcontextprotocol/sdk om MCP servers te bouwen. Het bronbestand src/endpoints.js bevat de lijst met ondersteunde tools. Voeg hier nieuwe endpoints toe wanneer de Quotelijst API uitbreidt en de tools worden automatisch aangemaakt.