jena-mcp 0.8.0

Apache Jena (Fuseki) API + MCP Server + A2A Server for Agentic AI!

jena-mcp

A Model Context Protocol (MCP) server, A2A agent, and API client for Apache Jena (Fuseki) integration.

Documentation — Installation, deployment, usage across the API, CLI, and MCP interfaces, and guidance for provisioning the Apache Jena Fuseki platform are maintained in the official documentation.

Table of Contents

• Overview
• Installation
• Usage
• Architecture
• Deployment
• Environment Variables
• MCP Tools
• Documentation

Overview

jena-mcp exposes a standardized interface to interact with an Apache Jena Fuseki server using the Model Context Protocol — SPARQL query/update, the Graph Store Protocol, and Fuseki server administration — plus an optional Pydantic-AI agent server.

Installation

pip install -e .

Usage

Run the MCP server directly:

python -m jena_mcp

Architecture

See /docs for architectural diagrams and further documentation.

Deployment

Bare-metal

python -m jena_mcp.agent_server

Docker

docker compose -f docker/agent.compose.yml up -d

Additional Deployment Options

jena-mcp can also run as a local container (Docker / Podman / uv) or be consumed from a remote deployment. The Deployment guide has full, copy-paste mcp_config.json for all four transports — stdio, streamable-http, local container / uv, and remote URL:

• Local container / uv — launch the server from mcp_config.json via uvx, docker run, or podman run, or point at a local streamable-http container by url.
• Remote URL — connect to a server deployed behind Caddy at http://jena-mcp.arpa/mcp using the "url" key.

Environment Variables

Variable	Description
JENA_FUSEKI_URL	Fuseki server base URL (alias: JENA_URL)
JENA_USERNAME	Basic-auth user id
JENA_PASSWORD	Basic-auth password
JENA_TOKEN	Bearer token (used in place of basic auth)
JENA_SSL_VERIFY	Verify TLS (set False for self-signed homelab)
JENATOOL	Register the Jena tool set

MCP Tools

Tool	Description
jena_sparql	Run a SPARQL query or update against a Fuseki dataset
jena_graph	Read or modify RDF graphs via the Graph Store Protocol
jena_admin	Administer the Fuseki server: datasets, stats, tasks, backup, compact

Documentation

The complete documentation is published as the official documentation site and is the recommended reference for installation, deployment, and day-to-day operation.

Page	Contents
Installation	pip, source, extras, prebuilt Docker image
Deployment	run the MCP and agent servers, Compose, Caddy + Technitium, env config
Usage	the MCP tools, the JenaApi client, the CLI
Backing Platform	deploy Apache Jena Fuseki with Docker
Overview	tool surface, endpoints, components
Architecture	layered client, MCP surface, agent server
Concepts	concept registry (CONCEPT:JENA-*)

AGENTS.md is the canonical contributor/agent guidance.