Timelines

Timelines MCP Server is a FastMCP-based tool that helps language models maintain coherent, time-aware narratives. It tracks events, timelines, and characters across long-form fiction or historical accounts, improving consistency and memory for extended generations.

How to use

You run the Timelines MCP Server locally and connect your MCP client to it to manage and query a shared narrative timeline. Use the client to create timelines, add events, attach characters, and retrieve context for future generations. The server handles persistence, concurrency, and the orchestration of domain objects such as Timeline, Event, and Character, so your model can focus on generating coherent narrative passages.

How to install

Prerequisites you need before installing:

• Python 3.8 or newer installed on your system.

• A working Internet connection to install Python packages.

Follow these steps to install and run the server in development mode:

How to install continuation

# Install in development mode
pip install -e .

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

Run the server

Start the MCP server locally so you can connect your MCP client and begin issuing commands to manage narratives.

python -m timelines_mcp.server

Notes on testing and quality tooling

The project uses pytest for running tests and ruff for linting and formatting. You can run the test suite and check code quality to ensure the server behaves as expected.

Additional considerations

This server is designed to be integrated with MCP clients via FastMCP. It includes domain models for timelines, events, and characters, and supports adapters for persistence and tools for common narrative-management tasks. When developing or debugging, you can run tests, lint, and format code to maintain a clean codebase.