Skip to content

Installation

jena-mcp is a standard Python package and a prebuilt container image. Pick the path that matches how the operator want to run it.

Requirements

  • Python 3.11 – 3.14.
  • A reachable Apache Jena Fuseki server — see Backing Platform to deploy one locally.
pip install jena-mcp

Optional extras

The base install is intentionally minimal. Install the extra for what the operator need:

Extra Install Pulls in
mcp pip install "jena-mcp[mcp]" FastMCP MCP-server runtime (scion-sdk)
test pip install "jena-mcp[test]" pytest, pytest-asyncio, pytest-cov, pytest-xdist

From source

git clone https://github.com/Knuckles-Team/jena-mcp.git
cd jena-mcp
pip install -e ".[all]"          # editable install with every extra

With uv:

uv pip install -e ".[all]"
uv run jena-mcp

Prebuilt Docker image

A multi-stage runtime image is published on every release (installs jena-mcp[all], entrypoint jena-mcp):

docker pull example/jena-mcp@sha256:<digest>

docker run --rm -i \
  -e JENA_FUSEKI_URL=http://your-fuseki:3030 \
  -e JENA_USERNAME=admin \
  -e JENA_PASSWORD=admin \
  example/jena-mcp@sha256:<digest>          # stdio transport (default)

For an HTTP server with a published port, see Deployment.

Verify the install

jena-mcp --help
python -c "import jena_mcp; print(jena_mcp.__version__)"

Next steps

  • Usage — call the tools, the JenaApi client, and the CLI.
  • Configuration — every environment variable.