MCP Server for Apache Jena

A Model Context Protocol (MCP) server that connects AI agents to Apache Jena for SPARQL query capabilities.

Overview

This project implements an MCP server that allows AI agents (such as Cursor, Claude for Cline, or Claude Desktop) to access and query RDF data stored in Apache Jena. The server provides tools for executing SPARQL queries and updates against a Jena Fuseki server.

Features

Execute SPARQL queries against a Jena Fuseki server
Execute SPARQL updates to modify RDF data
List available named graphs in the dataset
HTTP Basic authentication support for Jena Fuseki
Compatible with the Model Context Protocol

Prerequisites

Node.js (v16 or later)
Apache Jena Fuseki server running with your RDF data loaded
An AI agent that supports the Model Context Protocol (e.g., Cursor, Claude for Cline)

Installation

Clone this repository:

git clone https://github.com/ramuzes/mcp-jena.git
cd mcp-jena

Install dependencies:
```
npm install
```
Build the TypeScript code:
```
npm run build
```

Usage

Run the server with default settings (localhost:3030 for Jena, 'ds' for dataset):

npm start

Or specify custom Jena endpoint, dataset, and authentication credentials:

npm start -- --endpoint http://your-jena-server:3030 --dataset your_dataset --username your_username --password your_password

You can also use short flags:

npm start -- -e http://your-jena-server:3030 -d your_dataset -u your_username -p your_password

For development mode with automatic transpilation:

npm run dev:transpile -- -e http://your-jena-server:3030 -d your_dataset -u your_username -p your_password

Docker

You can run the MCP Jena server using Docker:

Building the Docker image

docker build -t mcp-jena .

Running with Docker

docker run -e JENA_FUSEKI_URL=http://your-jena-server:3030 -e DEFAULT_DATASET=your_dataset mcp-jena

Available Tools

This MCP server provides the following tools:

execute_sparql_query - Execute a SPARQL query against the Jena dataset
- Includes comprehensive SPARQL syntax documentation
- Property path operators (/, *, +, ?, ^, |) with examples
- Common query patterns and templates
- Automatic query validation and suggestions
execute_sparql_update - Execute a SPARQL update query to modify the dataset
- Insert/Delete operations documentation
- Conditional updates with WHERE clauses
- Graph management operations
list_graphs - List all available named graphs in the dataset
- Graph usage patterns and best practices
- Provenance and versioning examples
sparql_query_templates - Get pre-built SPARQL query templates
- exploration: Basic data discovery and statistics
- property-paths: Complex graph navigation patterns
- statistics: Knowledge graph metrics and analysis
- validation: Data quality and consistency checks
- schema: Structure discovery and documentation

Environment Variables

You can also configure the server using environment variables:

JENA_FUSEKI_URL: URL of your Jena Fuseki server (default: http://localhost:3030)
DEFAULT_DATASET: Default dataset name (default: ds)
JENA_USERNAME: Username for HTTP Basic authentication to Jena Fuseki
JENA_PASSWORD: Password for HTTP Basic authentication to Jena Fuseki
PORT: Port for the MCP server (for HTTP transport, default: 8080)
API_KEY: API key for MCP server authentication

Example SPARQL Queries

Basic SELECT query:

SELECT ?subject ?predicate ?object
WHERE {
  ?subject ?predicate ?object
}
LIMIT 10

Insert data with UPDATE:

PREFIX ex: <http://example.org/>
INSERT DATA {
  ex:subject1 ex:predicate1 "object1" .
  ex:subject2 ex:predicate2 42 .
}

Query a specific named graph:

SELECT ?subject ?predicate ?object
FROM NAMED <http://example.org/graph1>
WHERE {
  GRAPH <http://example.org/graph1> {
    ?subject ?predicate ?object
  }
}
LIMIT 10

Resources