MCP 服务器

RCE CHO SPARQL MCP Server

Enables LLMs to query the RCE Cultural Heritage SPARQL endpoint using ontology context, query validation, and predefined tools.

README

RCE CHO SPARQL MCP Server

MCP server waarmee een LLM het RCE Cultureel Erfgoed SPARQL endpoint kan bevragen. Gebouwd op de CEO ontologie (automatisch geladen van GitHub) en de RCE datamodelregels.

Remote gebruik (geen installatie nodig)

De server draait publiek op Render en is direct te gebruiken:

https://mcp-server-rce-cho-http.onrender.com/mcp

Claude Desktop (via mcp-remote proxy)

{
  "mcpServers": {
    "rce-cho-sparql": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp-server-rce-cho-http.onrender.com/mcp"]
    }
  }
}

Cursor

Voeg toe aan .cursor/mcp.json:

{
  "mcpServers": {
    "rce-cho-sparql": {
      "url": "https://mcp-server-rce-cho-http.onrender.com/mcp"
    }
  }
}

Open WebUI / andere MCP clients

Gebruik de URL direct: https://mcp-server-rce-cho-http.onrender.com/mcp

Let op: de server draait op de gratis Render-tier en kan na 15 minuten inactiviteit sluimeren. De eerste aanroep na een pauze duurt dan 20-30 seconden.

Lokale installatie

git clone https://github.com/rschalkrce/MCP-server-RCE-CHO-http.git
cd MCP-server-RCE-CHO-http
pip install -r requirements.txt
python server.py

Koppelen aan Claude Desktop (lokaal)

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rce-cho-sparql": {
      "command": "python",
      "args": ["/pad/naar/server.py"]
    }
  }
}

Beschikbare tools

Tool	Beschrijving
`get_ontology_context`	Geeft de volledige ontologie-context terug (klassen, properties, paden, spelregels). Altijd eerst aanroepen.
`query_sparql`	Voert een SPARQL SELECT/ASK query uit op het endpoint
`validate_query`	Checkt een query op veelgemaakte fouten vóór uitvoering
`describe_resource`	DESCRIBE op een specifieke URI
`get_provincie_uri`	Geeft de correcte URI voor een Nederlandse provincie

Hoe het werkt

LLM roept get_ontology_context() aan → krijgt alle klassen, properties en spelregels
LLM stelt SPARQL query op op basis van de ontologie
LLM roept validate_query(query) aan → fouten worden geblokkeerd
LLM roept query_sparql(query) aan → resultaten uit de brondata
LLM presenteert resultaten in mensentaal

Omgevingsvariabelen

Variabele	Standaard	Omschrijving
`SPARQL_ENDPOINT`	RCE CHO endpoint	SPARQL endpoint URL
`MCP_TRANSPORT`	`stdio`	`stdio`, `http` of `sse`
`CEO_TTL_URL`	GitHub URL	URL naar de CEO ontologie TTL

Technische details

SPARQL endpoint: https://api.linkeddata.cultureelerfgoed.nl/datasets/rce/cho/services/cho/sparql
Graph: https://linkeddata.cultureelerfgoed.nl/graph/instanties-rce
Ontologie: CEO v1.5, automatisch geladen van GitHub
Licentie: CC0 1.0