Haervwe/timelines-mcp

timelines-mcp

MCP server to aid LLMs in maintaining coherent long generations for time dependent narratives (fiction / history).

Overview

This is a FastMCP server that helps Language Models maintain coherent timelines, track events, and manage characters across long-form narratives, whether fiction or historical accounts.

Project Structure

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

Installation

# Install in development mode
pip install -e .

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

Development

The project uses:

• FastMCP for the MCP server framework
• pytest for testing
• ruff for linting and formatting

Running Tests

pytest

Linting

ruff check .
ruff format .

Usage

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

License

See LICENSE file for details.