Perseus MCP is a local FastMCP server that gives MCP-capable clients structured tools for Greek text research against Perseus CTS and Scaife search.

End-User Guide

Install the server, connect it to an MCP client, discover URNs, retrieve passages, and troubleshoot common setup issues.

Architecture

Understand the FastMCP host, upstream services, request helpers, tool behavior, error model, and extension points.

Notebooks

Browse example notebooks for CTS workflows, MCP tool calls, Greek search, navigation, and optional LLM integration.

Contributing

Report bugs, request features, contribute focused pull requests, and share reproducible examples for upstream data issues.

License

Review the MIT License terms for using, modifying, and distributing Perseus MCP.

Quick Start

Install dependencies from the project root:

uv sync

Run the server:

uv run server.py

Configure an MCP-capable client with the same local command:

uv --directory /full/path/to/Perseus-mcp run server.py