Oak

A model context protocol (MCP) to help agents interact with ontologies and the ontology access kit

Quick Start

# Install dependencies and set up development environment
make dev

# Run the MCP server
make run-server

# Run tests
make test

Installation

Using uvx (Recommended)

# Install and run directly with uvx
uvx oak-mcp

Development Installation

# Install in development mode (includes dependencies)
make dev-install

Usage

Testing MCP Protocol

make test-mcp

Integration with AI Tools

Claude Desktop

Add this to your Claude Desktop configuration file:

{
  "mcpServers": {
    "oak-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oak-mcp"
      ],
      "env": {}
    }
  }
}

Claude Code

claude mcp add oak-mcp uvx oak-mcp

Goose

goose session --with-extension "uvx oak-mcp"

Development

# Full development setup
make dev

# Run tests
make test

# Check dependencies
make check-deps

# Clean build artifacts
make clean

License

BSD-3-Clause