MCP.so
Sign In
C

Chronicle MCP

@Leviathan0x0

Repository

About Chronicle MCP

Chronicle MCP is a high-performance, universal local chat history archive connector designed specifically for Model Context Protocol (MCP) clients like Cursor, Claude Code, and daily development environments. Built natively in Python, it serves as an intelligent local storage and

#mcp#python#chat-history#logs#context-saving#token-efficiency#chatgpt#claude#local-storage#indexing#semantic-search#productivity#workflow#dev-tools#diagnostics

Basic information

Category

AI & Agents

Transports

stdio

Publisher

Leviathan0x0

Submitted by

Leviathan

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "chronicle-mcp": {
      "command": "uvx",
      "args": [
        "chronicle-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Chronicle MCP?

Chronicle MCP is a production-grade Model Context Protocol server that syncs, cleans, formats, and indexes local artificial intelligence chat transcripts. It allows agents to search, compare, retrieve, and reference past conversation logs while using optimized token-saving heuristics that can reduce context window utilization by up to 40%.

How to use Chronicle MCP?

Install the server and run chronicle to launch the stdio transport for MCP clients. Use chronicle add to configure IDE integrations (Cursor, Claude Code, VS Code, Trae) with automatic path resolution, and chronicle split to break monolithic chat exports into individual files. Customize the storage folder with --chats-folder.

Key features of Chronicle MCP

  • Format normalization engine for ChatGPT, Claude, generic JSON, and Markdown.
  • Context token optimization with code block summarization and length limiting.
  • Six versatile tools: search, read, sync, compile insights, maintain storage.
  • Cross-platform path resolution for macOS, Windows, and Linux.
  • Native IDE integration with fallback engine for emerging platforms.
  • Structural split engine for large conversation JSON exports.

Use cases of Chronicle MCP

  • Search and filter local chat transcripts by keyword, semantic similarity, or date range.
  • Import and sync conversation exports from ChatGPT or Claude into a local archive.
  • Compare two chat transcripts to identify shared and unique terms.
  • Extract action items, task lists, and checkboxes from chat logs.
  • Compile a project brief by synthesizing multiple chat summaries into one document.

FAQ from Chronicle MCP

Which chat export formats are supported?

Chronicle normalizes exports from ChatGPT (nested mapping nodes), Claude (flat chat_messages lists), and generic JSON or Markdown logs from tools like Cline or Continue.

How does token optimization work?

It automatically replaces verbose code blocks with metadata summaries (language and line count) and truncates extremely long messages at a configurable character threshold.

How can I split a large conversation file?

Use the chronicle split subcommand followed by the path to the JSON file and an output directory, e.g., chronicle split /path/to/conversations.json --out /path/to/output_directory.

How do I configure a custom storage folder?

Run chronicle --chats-folder /path/to/custom/chats to save a custom global folder path in ~/.chronicle_settings.json.

Which IDEs are supported out of the box?

Chronicle directly integrates with Cursor, Claude Code, VS Code (Cline/RooCode/Continue), and Trae, with a dynamic fallback engine for other platforms.

Comments

More AI & Agents MCP servers

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622

MCP Manager for Claude Desktop

zueai

simple web ui to manage mcp (model context protocol) servers in the claude app

290

MCP Server - Remote MacOs Use

baryhuang

The only general AI agent that does NOT requires extra API key, giving you full control on your local and remote MacOs from Claude Desktop App

487

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K

欢迎来到 智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797