|
| 1 | +# ruff: noqa: D103 |
| 2 | +from __future__ import annotations |
| 3 | + |
| 4 | +import argparse |
| 5 | +import json |
| 6 | +import logging |
| 7 | +import os |
| 8 | +import time |
| 9 | +from functools import wraps |
| 10 | +from importlib.metadata import PackageNotFoundError |
| 11 | +from importlib.metadata import version as pkg_version |
| 12 | +from typing import Any, Callable |
| 13 | + |
| 14 | +from mcp.server.fastmcp import FastMCP |
| 15 | +from sqlalchemy import create_engine |
| 16 | +from starlette.requests import Request |
| 17 | +from starlette.responses import JSONResponse |
| 18 | + |
| 19 | +from config import config |
| 20 | +from kvk_connect import logging_config |
| 21 | +from kvk_connect.db.mcp_onbekend_vraag_writer import McpOnbekendVraagWriter |
| 22 | +from kvk_connect.db.mirror_reader import KVKMirrorReader |
| 23 | +from kvk_connect.db.init import ensure_database_initialized |
| 24 | +from kvk_connect.models.orm.base import Base |
| 25 | +from kvk_connect.services.mirror_service import KVKMirrorService |
| 26 | + |
| 27 | +logger = logging.getLogger(__name__) |
| 28 | + |
| 29 | +_host = os.getenv("MCP_HOST", "0.0.0.0") |
| 30 | +_port = int(os.getenv("MCP_PORT", "8000")) |
| 31 | +mcp = FastMCP("kvk-connect", host=_host, port=_port, stateless_http=True) |
| 32 | +_service: KVKMirrorService | None = None |
| 33 | + |
| 34 | + |
| 35 | +# --------------------------------------------------------------------------- |
| 36 | +# Logging decorator |
| 37 | +# --------------------------------------------------------------------------- |
| 38 | + |
| 39 | + |
| 40 | +def log_tool_call(fn: Callable) -> Callable: |
| 41 | + """Logt tool naam, resultaatstatus en uitvoertijd.""" |
| 42 | + |
| 43 | + @wraps(fn) |
| 44 | + async def wrapper(*args: Any, **kwargs: Any) -> Any: |
| 45 | + first_arg = next(iter(kwargs.values()), args[0] if args else "") |
| 46 | + logger.info("→ %s(%s)", fn.__name__, str(first_arg)[:40]) |
| 47 | + start = time.monotonic() |
| 48 | + try: |
| 49 | + result = await fn(*args, **kwargs) |
| 50 | + elapsed_ms = int((time.monotonic() - start) * 1000) |
| 51 | + logger.info("← %s OK [%dms]", fn.__name__, elapsed_ms) |
| 52 | + return result |
| 53 | + except Exception: |
| 54 | + elapsed_ms = int((time.monotonic() - start) * 1000) |
| 55 | + logger.error("← %s ERROR [%dms]", fn.__name__, elapsed_ms, exc_info=True) |
| 56 | + raise |
| 57 | + |
| 58 | + return wrapper |
| 59 | + |
| 60 | + |
| 61 | +# --------------------------------------------------------------------------- |
| 62 | +# Health endpoint |
| 63 | +# --------------------------------------------------------------------------- |
| 64 | + |
| 65 | + |
| 66 | +@mcp.custom_route("/health", methods=["GET"]) |
| 67 | +async def health(request: Request) -> JSONResponse: |
| 68 | + return JSONResponse({"status": "ok"}) |
| 69 | + |
| 70 | + |
| 71 | +# --------------------------------------------------------------------------- |
| 72 | +# Laag 1: exacte lookups |
| 73 | +# --------------------------------------------------------------------------- |
| 74 | + |
| 75 | + |
| 76 | +@mcp.tool() |
| 77 | +@log_tool_call |
| 78 | +async def get_bedrijf(kvk_nummer: str, include_non_mailing: bool = False) -> str: |
| 79 | + """Geeft basisprofiel voor KVK-nummer (8 cijfers, bijv. '12345678').""" |
| 80 | + assert _service is not None |
| 81 | + return json.dumps(_service.get_bedrijf(kvk_nummer, include_non_mailing=include_non_mailing)) |
| 82 | + |
| 83 | + |
| 84 | +@mcp.tool() |
| 85 | +@log_tool_call |
| 86 | +async def get_vestiging(vestigingsnummer: str) -> str: |
| 87 | + """Geeft vestigingsprofiel voor vestigingsnummer (12 cijfers, bijv. '000012345678').""" |
| 88 | + assert _service is not None |
| 89 | + return json.dumps(_service.get_vestiging(vestigingsnummer)) |
| 90 | + |
| 91 | + |
| 92 | +@mcp.tool() |
| 93 | +@log_tool_call |
| 94 | +async def list_vestigingen(kvk_nummer: str, include_non_mailing: bool = False) -> str: |
| 95 | + """Geeft alle vestigingsnummers en locatiedata voor KVK-nummer (8 cijfers).""" |
| 96 | + assert _service is not None |
| 97 | + return json.dumps(_service.list_vestigingen(kvk_nummer, include_non_mailing=include_non_mailing)) |
| 98 | + |
| 99 | + |
| 100 | +@mcp.tool() |
| 101 | +@log_tool_call |
| 102 | +async def get_alles(kvk_nummer: str, include_non_mailing: bool = False) -> str: |
| 103 | + """Geeft basisprofiel plus alle vestigingsdetails voor KVK-nummer (8 cijfers) in één aanroep.""" |
| 104 | + assert _service is not None |
| 105 | + return json.dumps(_service.get_alles(kvk_nummer, include_non_mailing=include_non_mailing)) |
| 106 | + |
| 107 | + |
| 108 | +@mcp.tool() |
| 109 | +@log_tool_call |
| 110 | +async def check_doorstarter(kvk_nummer: str) -> str: |
| 111 | + """Zoekt actieve opvolger op hetzelfde adres voor KVK-nummer (8 cijfers).""" |
| 112 | + assert _service is not None |
| 113 | + return json.dumps(_service.check_doorstarter(kvk_nummer)) |
| 114 | + |
| 115 | + |
| 116 | +# --------------------------------------------------------------------------- |
| 117 | +# Laag 2: analytisch |
| 118 | +# --------------------------------------------------------------------------- |
| 119 | + |
| 120 | + |
| 121 | +@mcp.tool() |
| 122 | +@log_tool_call |
| 123 | +async def zoek_op_naam_prefix(naam_prefix: str, limit: int = 25) -> str: |
| 124 | + """Zoekt bedrijven op naam-prefix (bijv. 'Bakkerij'). Maximaal 100 resultaten.""" |
| 125 | + assert _service is not None |
| 126 | + return json.dumps(_service.zoek_op_naam_prefix(naam_prefix, limit=limit)) |
| 127 | + |
| 128 | + |
| 129 | +@mcp.tool() |
| 130 | +@log_tool_call |
| 131 | +async def filter_op_sbi(sbi_prefix: str, gemeente: str = "", limit: int = 100) -> str: |
| 132 | + """Geeft actieve vestigingen voor SBI-sector (bijv. '86' voor zorg), optioneel gefilterd op gemeente.""" |
| 133 | + assert _service is not None |
| 134 | + return json.dumps(_service.filter_op_sbi(sbi_prefix, gemeente=gemeente or None, limit=limit)) |
| 135 | + |
| 136 | + |
| 137 | +@mcp.tool() |
| 138 | +@log_tool_call |
| 139 | +async def check_actiefstatus_batch(kvk_nummers: list[str]) -> str: |
| 140 | + """Controleert actiefstatus voor een lijst KVK-nummers (maximaal 200 per aanroep).""" |
| 141 | + assert _service is not None |
| 142 | + try: |
| 143 | + return json.dumps(_service.check_actiefstatus_batch(kvk_nummers)) |
| 144 | + except ValueError as e: |
| 145 | + return json.dumps({"status": "fout", "bericht": str(e), "data_quality": {"coverage_warnings": []}}) |
| 146 | + |
| 147 | + |
| 148 | +# --------------------------------------------------------------------------- |
| 149 | +# Laag 3: onbekende vragen + historie |
| 150 | +# --------------------------------------------------------------------------- |
| 151 | + |
| 152 | + |
| 153 | +@mcp.tool() |
| 154 | +@log_tool_call |
| 155 | +async def report_onbekende_vraag(vraag: str) -> str: |
| 156 | + """Registreer een vraag die niet beantwoord kan worden met de beschikbare tools.""" |
| 157 | + assert _service is not None |
| 158 | + return json.dumps(_service.report_onbekende_vraag(vraag)) |
| 159 | + |
| 160 | + |
| 161 | +@mcp.tool() |
| 162 | +@log_tool_call |
| 163 | +async def get_basisprofiel_historie(kvk_nummer: str) -> str: |
| 164 | + """Geeft de wijzigingsgeschiedenis van een basisprofiel voor KVK-nummer (8 cijfers).""" |
| 165 | + assert _service is not None |
| 166 | + return json.dumps(_service.get_basisprofiel_historie(kvk_nummer)) |
| 167 | + |
| 168 | + |
| 169 | +@mcp.tool() |
| 170 | +@log_tool_call |
| 171 | +async def get_vestigingsprofiel_historie(vestigingsnummer: str) -> str: |
| 172 | + """Geeft de wijzigingsgeschiedenis van een vestigingsprofiel voor vestigingsnummer (12 cijfers).""" |
| 173 | + assert _service is not None |
| 174 | + return json.dumps(_service.get_vestigingsprofiel_historie(vestigingsnummer)) |
| 175 | + |
| 176 | + |
| 177 | +# --------------------------------------------------------------------------- |
| 178 | +# Entrypoint |
| 179 | +# --------------------------------------------------------------------------- |
| 180 | + |
| 181 | + |
| 182 | +_VALID_TRANSPORTS = {"stdio", "sse", "streamable-http"} |
| 183 | + |
| 184 | + |
| 185 | +def main() -> None: |
| 186 | + global _service |
| 187 | + |
| 188 | + transport = os.getenv("MCP_TRANSPORT", "streamable-http") |
| 189 | + if transport not in _VALID_TRANSPORTS: |
| 190 | + raise SystemExit(f"Ongeldig MCP_TRANSPORT={transport!r}, kies uit {_VALID_TRANSPORTS}") |
| 191 | + |
| 192 | + parser = argparse.ArgumentParser(description="KVK-Connect MCP server.") |
| 193 | + parser.add_argument("--debug", action="store_true", help="Enable DEBUG log level.") |
| 194 | + args = parser.parse_args() |
| 195 | + |
| 196 | + log_level = logging.DEBUG if args.debug else logging.INFO |
| 197 | + logging_config.configure(level=log_level) |
| 198 | + |
| 199 | + try: |
| 200 | + app_version = pkg_version("kvk-connect") |
| 201 | + except PackageNotFoundError: |
| 202 | + app_version = "onbekend" |
| 203 | + logger.info("kvk-connect mcp-server v%s gestart", app_version) |
| 204 | + |
| 205 | + engine = create_engine(config.SQLALCHEMY_DATABASE_URI, pool_pre_ping=True) |
| 206 | + ensure_database_initialized(engine, Base) |
| 207 | + |
| 208 | + reader = KVKMirrorReader(engine) |
| 209 | + writer = McpOnbekendVraagWriter(engine) |
| 210 | + _service = KVKMirrorService(reader, writer) |
| 211 | + |
| 212 | + if transport == "stdio": |
| 213 | + logger.info("MCP server gestart in STDIO-modus") |
| 214 | + else: |
| 215 | + logger.info("MCP server luistert op %s:%d (%s)", _host, _port, transport) |
| 216 | + mcp.run(transport=transport) |
| 217 | + |
| 218 | + |
| 219 | +if __name__ == "__main__": |
| 220 | + main() |
0 commit comments