Universal CLI History MCP Server

一个通用的 MCP 服务器，用于管理和搜索所有 CLI 命令行工具的历史记录。

🚀 支持的工具

Shell 工具

• bash - .bash_history
• zsh - .zsh_history
• fish - fish_history
• PowerShell - ConsoleHost_history.txt

开发工具

• git - git commit 历史
• Node.js - .node_repl_history
• Python - .python_history
• npm/yarn - package manager 命令

系统工具

• docker - docker 相关命令
• apt/brew - 包管理器
• curl/wget - 网络工具
• ssh/scp - 远程连接
• rsync - 文件同步

通用命令

• ls, cd, pwd, cat, grep, find
• mkdir, rm, cp, mv
• 所有其他系统命令

🔧 功能特性

list_history - 列出历史命令

• 查看所有 CLI 工具的历史命令
• 按工具过滤：git, docker, npm, node, python, shell 等
• 限制返回数量

search_history - 搜索历史命令

• 在所有历史命令中搜索关键词
• 按工具过滤搜索范围

get_tool_stats - 使用统计

• 查看各工具的使用频率
• 统计总命令数
• 识别最常用工具

execute_command - 执行命令

• 执行 CLI 命令并自动记录到历史
• 自动识别工具类型

📊 可用资源

cli-history://all

获取所有 CLI 历史命令的 JSON 格式数据。

cli-history://stats

获取各工具使用统计的 JSON 数据。

🛠️ 安装配置

1. 安装依赖

cd universal-cli-history-mcp
npm install
npm run build

2. 配置 Claude Desktop

{
  "mcpServers": {
    "universal-cli-history": {
      "command": "node",
      "args": ["/absolute/path/to/universal-cli-history-mcp/dist/index.js"]
    }
  }
}

3. 配置 Claude Code

{
  "mcpServers": {
    "universal-cli-history": {
      "command": "node",
      "args": ["/absolute/path/to/universal-cli-history-mcp/dist/index.js"]
    }
  }
}

🔍 使用示例

查看最近命令

list_history { "limit": 20 }

搜索 Git 命令

search_history { "query": "commit", "tool": "git" }

查看统计

get_tool_stats {}

执行命令

execute_command { "command": "git status" }

📁 项目结构

universal-cli-history-mcp/
├── src/
│   └── index.ts          # 主服务器文件
├── dist/                 # 编译输出
├── package.json
├── tsconfig.json
└── README.md

🔄 自动检测

服务器会自动检测和加载：

• 各种 shell 的历史文件
• Git 仓库的提交历史
• Node.js/Python REPL 历史
• 系统命令历史
• Docker 相关命令

⚡ 开发

运行开发版本

npm run dev

构建生产版本

npm run build

启动生产版本

npm start

📝 许可证

MIT