Perseus MCP is a local FastMCP server that gives MCP-capable clients structured tools for Greek and Latin 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 syncRun the server:
uv run server.pyConfigure an MCP-capable client with the same local command:
uv --directory /full/path/to/Perseus-mcp run server.pyResponsible Disclosure
This project was created with assistance from OpenAI Codex. The human maintainer remains responsible for reviewing, testing, and accepting all code and documentation changes.