Skip to main content
Glama
Timelines MCP Server

Timelines MCP Server

by Haervwe

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.

Related MCP server: Alethea World History Engine

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to build and query temporally-aware knowledge graphs from conversations and data, maintaining persistent memory of entities, relationships, and facts across interactions.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A narrative graph engine that enables LLMs to generate, track, and mutate complex fictional worlds while maintaining consistency between factions, characters, and locations. It acts as a specialized RAG framework for storytelling, allowing models to manage thousands of entities without exceeding context limits.
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables persistent memory for AI systems by providing tools for episodic, semantic, and procedural data storage through a vector-and-graph-enhanced database. It allows models to maintain long-term continuity using similarity search, thematic clustering, and identity tracking.
      24
      1
      -
    • A
      license
      A
      quality
      B
      maintenance
      Provides long-term memory and a temporal knowledge graph for AI agents, enabling persistent memory and reasoning across sessions.
      33
      2
      MIT