Python 3.13+ MCP 1.0 ChromaDB License: MIT

oarx-docs-mcp

MCP server for semantic search across the complete ObjectARX 2026 documentation set. 89,715 text chunks from 22 guides indexed in ChromaDB with hybrid BM25 + dense retrieval.

Overview

oarx-docs-mcp indexes 89,715 text chunks from 22 documentation guides into a local ChromaDB vector database and exposes them through the Model Context Protocol (MCP) for use with Claude Code, Claude Desktop, or any MCP-compatible client.

Highlights

• 3 MCP tools — search_docs, lookup_class, list_guides
• 89,715 indexed chunks from 22 documentation guides (ObjectARX SDK + Autodesk CloudHelp)
• Hybrid retrieval — BM25 sparse + dense vectors + Reciprocal Rank Fusion
• Cross-encoder reranking with BAAI/bge-reranker-v2-m3
• Query optimization — AutoLISP detection, C++ API expansion, guide-specific boosting
• Container-ready — Containerfile + compose.yaml (Podman/Docker)
• Claude Code plugin — 4 skills + 2 slash commands for ObjectARX development

Data Sources

MCP Tools

Quick Start

# Clone and install
cd mcp/oarx-docs-mcp
uv sync

# Download web documentation (~5,000 pages)
OARX_DATA_DIR=./data uv run python -m oarx_docs_mcp.scraper

# Index CHM files from ObjectARX SDK (optional, requires 7-Zip)
OARX_DATA_DIR=./data OARX_CHM_DIR=/path/to/sdk/docs uv run python -m oarx_docs_mcp.indexer

# Or index web docs only (no SDK needed)
OARX_DATA_DIR=./data uv run python -m oarx_docs_mcp.indexer

Client Configuration

{
  "mcpServers": {
    "oarx-docs": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/oarx-docs-mcp",
        "python", "-m", "oarx_docs_mcp"
      ],
      "env": {
        "OARX_DATA_DIR": "/path/to/oarx-docs-mcp/data"
      }
    }
  }
}

{
  "mcpServers": {
    "oarx-docs": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "C:/Users/user/oarx-docs-mcp",
        "python", "-m", "oarx_docs_mcp"
      ],
      "env": {
        "OARX_DATA_DIR": "C:/Users/user/oarx-docs-mcp/data"
      }
    }
  }
}

{
  "mcpServers": {
    "oarx-docs": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/oarx-docs-mcp",
        "python", "-m", "oarx_docs_mcp"
      ],
      "env": {
        "OARX_DATA_DIR": "/path/to/oarx-docs-mcp/data"
      }
    }
  }
}

[mcp_servers.oarx-docs]
command = "uv"
args = ["run", "--directory", "/path/to/oarx-docs-mcp", "python", "-m", "oarx_docs_mcp"]

[mcp_servers.oarx-docs.env]
OARX_DATA_DIR = "/path/to/oarx-docs-mcp/data"

codex mcp add oarx-docs --env OARX_DATA_DIR=/path/to/data -- uv run --directory /path/to/oarx-docs-mcp python -m oarx_docs_mcp

Container Setup

# Build image
podman-compose build

# Download web docs
podman-compose --profile scraper run --rm scraper

# Index (requires OARX_CHM_DIR env var for CHM files)
OARX_CHM_DIR=/path/to/sdk/docs podman-compose --profile indexer run --rm indexer

# Run server
podman-compose up server

Configuration

All settings are configurable via environment variables:

Development

# Install with dev dependencies
uv sync --all-extras

# Run tests
uv run python -m pytest tests/ -v

# Lint
uv run ruff check src/ tests/

# Type check
uv run mypy

Tech Stack

• Python 3.13+ with uv
• MCP SDK (FastMCP, stdio transport)
• ChromaDB (persistent vector store, HNSW + cosine)
• sentence-transformers (all-MiniLM-L6-v2, 384-dim embeddings)
• BeautifulSoup4 + lxml (HTML parsing)
• httpx (web documentation scraping)
• Podman / podman-compose (containerization)

Project Structure

oarx-docs-mcp/
├── src/oarx_docs_mcp/
│   ├── __main__.py          # Entry point
│   ├── config.py            # Settings + guide registries
│   ├── data_manager.py      # Database auto-download
│   ├── indexer.py           # CHM/HTML → ChromaDB
│   ├── retriever.py         # BM25 + dense + RRF + reranking
│   ├── scraper.py           # CloudHelp downloader
│   └── server.py            # MCP tools (3 tools)
├── tests/                   # pytest + pytest-asyncio
├── plugin/                  # Claude Code plugin
├── docs/
│   ├── en/                  # English documentation
│   └── ru/                  # Russian documentation
├── Containerfile            # OCI container image
└── compose.yaml             # Podman/Docker services

Documentation

Contributing

See CONTRIBUTING.md (RU).

License

MIT