广告合作
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 服务器

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

32

Yocoolab

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools

1

Termany

thinkany-ai

Agent-Native Terminal

174

Collide MCP

Lithometric Inc. | Collide Inc.

Collide is the multiplayer layer for AI coding agents, and it pays for itself. Expert orchestration across every agent on your repo saves teams tens to hundreds of dollars a day in token burn. Run Claude Code, Codex, Cu

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

1
广告合作