广告合作
MCP.so
登录

Terminal History MCP Server

@HasanJahidul

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

HasanJahidul

提交者

Jahidul Hasan

关于 Terminal History MCP Server

terminal-history-mcp gives AI agents (Claude Code, Cursor, Cline, Zed, any MCP client) full-text search over your shell history.

#terminal#shell#history#zsh#bash#fish#sqlite#fts5#search#local-first#privacy#cli#developer-tools#memory#mcp

Terminal History MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "terminal-history": {
      "command": "npx",
      "args": [
        "-y",
        "terminal-history-mcp"
      ]
    }
  }
}

Terminal History MCP Server 工具

5

Re-parses the local shell history files (`~/.zsh_history`, `~/.bash_history`) and the hook's extended log into the SQLite index. Idempotent — already-indexed commands are skipped by hash, so it is safe to call repeatedly. Run it after a burst of shell activity to make recent commands searchable. Reads only local files; writes only to `~/.terminal-history-mcp/`. Takes no arguments. Returns counts of parsed / inserted / skipped entries.

Read-only. Full-text search (SQLite FTS5, stemmed, Unicode-aware) over all indexed shell commands. Supports keyword and prefix queries — e.g. `docker build`, `git reb*`. Returns the most recent matches first, each with timestamp, shell, cwd, and exit code when available. Local index only; nothing is sent anywhere. If a query returns nothing you may need `reindex` first.

Read-only. Lists the most recent commands that were run with a given working directory — answers "what was I doing in this project?". Requires the shell hook to have been installed (legacy entries have no cwd and won't appear). Returns newest first with timestamps and exit codes. Local index only.

Read-only. Lists recent commands that exited non-zero — a quick "what just broke?" feed. Optionally restrict to commands after a given epoch-millisecond timestamp. Requires the shell hook for exit-code capture (legacy entries have no exit code). Newest first. Local index only.

Read-only. For each command matching `query`, returns the commands run within a time window around it (default ±5 min) — surfacing multi-step sequences like `cd → npm run build → deploy`. Useful for reconstructing "how did I do X last time?". Returns up to `limit` chains, each a time-ordered list of command rows. Local index only.

概览

What is Terminal History MCP?

Terminal History MCP lets AI coding agents search your local shell history (zsh, bash, fish) using SQLite FTS5 full‑text search. Commands are secret‑redacted before storage and never leave your machine.

How to use Terminal History MCP?

Install globally with npm, then run terminal-history-mcp index for a one‑time backfill and terminal-history-mcp install-hook to capture working directory, exit code, and duration. Alternatively, use zero‑install via npx by adding it to your mcpServers configuration. Tools available: reindex, search_history, recent_in_dir, failed_commands, command_chains.

Key features of Terminal History MCP

  • Local‑only SQLite FTS5 search of shell history
  • Supports zsh, bash, and fish shells
  • Secrets redacted before storage
  • Tools for search, recent commands, failures, chains
  • Idempotent reindex with hash dedupe
  • Zero network calls, fully offline

Use cases of Terminal History MCP

  • Recall long or forgotten commands from weeks ago
  • Investigate failed commands with non‑zero exit codes
  • Find commands run in a specific working directory
  • Get context windows around matching commands
  • Pair with localhost‑MCP for full dev environment memory

常见问题

1

What shells does Terminal History MCP support?

It supports zsh, bash, and fish. All three have both history parsing and optional hook‑based capture for exit code, duration, and working directory.

2

How is privacy managed?

Data stays entirely local. Secrets are redacted before insertion using 11 ordered patterns (GitHub PATs, OpenAI keys, AWS keys, etc.). The database is at `~/.terminal-history-mcp/history.db`.

3

Does Terminal History MCP require an internet connection?

No. It makes zero network calls and runs fully offline.

4

How do I install Terminal History MCP?

Install via `npm install -g terminal-history-mcp`, then index your history. Or skip installation by using `npx -y terminal-history-mcp` in your MCP client configuration.

5

What data is captured with the hook?

The optional hook captures the current working directory, exit code, and execution duration for each command, enriching the searchable history.

评论

开发工具 分类下的更多 MCP 服务器

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

1

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

9

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

3
广告合作