realtimex-docs-server 0.1.0

MCP server that exposes local documentation to agents

realtimex-docs-server

A FastMCP-based MCP server that makes local documentation available to RealTimeX agents.

Features

• Serve documentation from a configurable directory via CLI flag or environment variable
• List available documentation files using optional glob patterns
• Read documents as UTF-8 text with optional offset/limit line slicing
• Transport over stdio for MCP clients

Configuration

Set the documentation root via the --docs-path CLI option or the REALTIMEX_DOCS_ROOT environment variable (CLI flag takes precedence).

Usage

uvx realtimex-docs-server --docs-path /path/to/docs

Once connected, agents can call the list_documents and read_document tools to explore the configured directory. Provide patterns to list_documents for glob filtering when needed; omit it to list every document. read_document accepts offset and limit parameters to fetch a window of lines and returns plain UTF-8 content without added numbering.

Development

# Install dependencies
uv sync

# Run style or test tooling as needed
uv run ruff check
uv run pytest