Metadata-Version: 2.4
Name: oak-mcp
Version: 0.1.0
Summary: A model context protocol (MCP) to help agents interact with ontologies and the ontology access kit
Project-URL: Homepage, https://github.com/justaddcoffee/oak-mcp
Project-URL: Bug Tracker, https://github.com/justaddcoffee/oak-mcp/issues
Author-email: Justin Reese <justaddcoffee@gmail.com>
Requires-Python: >=3.11
Requires-Dist: fastmcp>=2.7.1
Requires-Dist: oaklib>=0.5.18
Requires-Dist: requests>=2.32.4
Description-Content-Type: text/markdown

# oak_mcp

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

## Quick Start

```bash
# Install dependencies and set up development environment
make dev

# Run the MCP server
make run-server

# Run tests
make test
```

## Installation

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

## Usage

### Testing MCP Protocol

```bash
make test-mcp
```

### Integration with AI Tools

#### Claude Desktop

Add this to your Claude Desktop configuration file:

```json
{
  "mcpServers": {
    "oak-mcp": {
      "command": "uv",
      "args": ["run", "python", "src/oak_mcp/main.py"],
      "cwd": "/path/to/oak-mcp"
    }
  }
}
```

#### Claude Code

```bash
claude mcp add -s project oak-mcp uv run python src/oak_mcp/main.py
```

#### Goose

```bash
goose session --with-extension "uv run python src/oak_mcp/main.py"
```

## Development

```bash
# Full development setup
make dev

# Run tests
make test

# Check dependencies
make check-deps

# Clean build artifacts
make clean
```

## License

BSD-3-Clause
