AI导哈

会话管理工具

用于管理Claude Code对话历史的会话管理工具，支持MCP协议和Web GUI界面。

  • by es6kr
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 es6kr/claude-session-manager-mcp

使用说明

克劳德会议经理mcp

MCP服务器，用于管理具有GUI支持的Claude Code对话会话。

管理您的Claude Code对话历史记录(~/.claude/projects)通过MCP工具或基于web的GUI界面。

特性

  • 📋 会话管理：列出、重命名和删除对话会话
  • 🗑️ 智能清理：自动识别和清理空会话或无效会话
  • 🌐 Web图形用户界面：用于浏览对话历史记录的漂亮web界面
  • 🔧 MCP集成：完全支持Claude Code的MCP协议
  • 🚀 简易安装：单线安装 uvx

安装

# Using uvx (recommended)
uvx claude-session-manager-mcp

# Or install globally
uv tool install claude-session-manager-mcp

# Web GUI
uvx --from claude-session-manager-mcp claude-session-manager-web

用法

克劳德代码MCP集成

添加到克劳德代码：

claude mcp add claude-session-manager -- uvx claude-session-manager-mcp

或手动编辑 ~/.claude.json:

{
  "mcpServers": {
    "claude-session-manager": {
      "command": "uvx",
      "args": ["claude-session-manager-mcp"]
    }
  }
}

Web图形用户界面

启动web界面：

# Direct launch
uvx --from claude-session-manager-mcp claude-session-manager-web

# Or via MCP tool (from Claude Code)
> Use the start_gui tool to launch web interface

GUI将在以下时间打开 http://localhost:5050 具有以下特点：

  • 浏览所有项目和会话
  • 搜索对话
  • 查看完整的对话历史记录
  • 使用内联编辑重命名会话
  • 删除不需要的会话
  • 批量清理空会话

MCP工具

工具 说明
list_projects 列出所有具有会话计数的Claude Code项目
list_sessions 列出特定项目中的所有会话
rename_session 在会话中添加描述性标题前缀
delete_session 删除会话（安全备份到.bak）
preview_cleanup 预览可清理的会话
clear_sessions 删除空的和无效的API密钥会话
start_gui 启动web GUI并在浏览器中打开
stop_gui 停止web GUI服务器

例子

通过克劳德代码

List all projects:
> @claude-session-manager list_projects

List sessions in a project:
> @claude-session-manager list_sessions project_name="-Users-young-works-myproject"

Rename a session:
> @claude-session-manager rename_session project_name="..." session_id="abc123" new_title="Fix authentication bug"

Launch web GUI:
> @claude-session-manager start_gui

通过CLI

# Run MCP server (stdio mode)
uvx claude-session-manager-mcp

# Launch web GUI
uvx --from claude-session-manager-mcp claude-session-manager-web

项目结构

~/.claude/projects/
├── -Users-young-works-project1/
│   ├── session1.jsonl
│   ├── session2.jsonl
│   └── agent-xxx.jsonl
├── -Users-young-works-project2/
└── .bak/                    # Deleted sessions backup
    └── project_session.jsonl

发展

# Clone repository
git clone https://github.com/es6kr/claude-session-manager-mcp.git
cd claude-session-manager-mcp

# Install dependencies
uv sync

# Run MCP server locally
uv run claude-session-manager-mcp

# Run web GUI locally
uv run claude-session-manager-web

# Run from project directory (development mode)
uv run --directory /path/to/claude-session-manager-mcp claude-session-manager-mcp

运作原理

  1. 会话检测：扫描 ~/.claude/projects/ 为了 .jsonl 文件
  2. 智能解析：从第一条用户消息中提取标题，删除IDE上下文标记
  3. 安全删除：将已删除的会话移动到 .bak 用于恢复的文件夹
  4. 清理逻辑：标识空会话和无效的API密钥错误
  5. Web服务器：带有RESTful API的基于Flask-based GUI

需求

  • Python 3.10+
  • 克劳德代码（用于MCP集成）
  • 现代网络浏览器（用于GUI）

贡献

欢迎在 github/es6kr/claude-session-manager-mcp

许可证

麻省理工学院

相关 MCP