timelines-mcp/
├── src/
│   └── timelines_mcp/
│       ├── __init__.py          # Main package initialization
│       ├── server.py            # FastMCP server entry point
│       ├── domain/              # Domain objects (Timeline, Event, Character, etc.)
│       │   └── __init__.py
│       ├── adapters/            # Database adapters for persistence
│       │   └── __init__.py
│       ├── tools/               # MCP tools exposed via FastMCP
│       │   └── __init__.py
│       └── agents/              # Agent implementations for complex operations
│           └── __init__.py
├── tests/                       # Test suite
│   └── __init__.py
├── pyproject.toml              # Python project configuration
├── README.md                   # This file
└── LICENSE

# Install in development mode
pip install -e .

# Install with development dependencies
pip install -e ".[dev]"

pytest

ruff check .
ruff format .

# Run the server (implementation details to be added)
python -m timelines_mcp.server