keonchennl/mcp-server-graphdb

A Model Context Protocol server that provides read-only access to Ontotext GraphDB. This server enables LLMs to explore RDF graphs and execute SPARQL queries against a GraphDB instance.
## Components
### Tools
sparqlQuery
Execute SPARQL queries against the connected GraphDB repository
Input:
query (string): The SPARQL query to execute
graph (string, optional): Specific graph IRI to target
format (string, optional): Response format (json, xml, csv)
All queries are executed in read-only mode
listGraphs
Lists all graphs available in the repository
No input parameters required
### Resources
The server provides multiple views of the repository data:
Class List (graphdb:// /repository/ /classes)
Lists all RDF classes found in the repository with counts
Predicates (graphdb:// /repository/ /predicates)
Lists all predicates (properties) with usage counts
Statistics (graphdb:// /repository/ /stats)
Provides counts of subjects, predicates, objects, and triples
Sample Data (graphdb:// /repository/ /sample)
Shows a sample of triples from the repository
Graph Content (graphdb:// /repository/ /graph/ )
Provides sample data from specific graphs along with metadata
## Configuration
You can configure the server using environment variables by creating a .env file:
GRAPHDBENDPOINT=http://localhost:7200
GRAPHDBREPOSITORY=myRepository
GRAPHDBUSERNAME=username
GRAPHDBPASSWORD=password
Alternatively, you can provide the endpoint and repository as command-line arguments:
node dist/index.js http://localhost:7200 myRepository
The command-line arguments take precedence over environment variables.
## Usage with Claude Desktop
To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claudedesktopconfig.json:
json
"mcpServers": {
"graphdb": {
"command": "node",
"args": [
"/path/to/mcp-server-graphdb/dist/index.js"
],
"env": {
"GRAPHDBENDPOINT": "http://localhost:7200",
"GRAPHDBREPOSITORY": "myRepository",
"GRAPHDBUSERNAME": "username",
"GRAPHDBPASSWORD": "password"
Replace the values with your specific GraphDB configuration.
## Installation
sh
# Clone the repository
git clone https://github.com/keonchennl/mcp-server-graphdb.git
cd mcp-server-graphdb
# Install dependencies
yarn install
# Build the project
yarn build
## Example SPARQL Queries
Here are some example SPARQL queries you can run with this server:
1. List all classes in the ontology:
sparql
PREFIX rdf:
PREFIX rdfs:
SELECT DISTINCT ?class ?label
WHERE {