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 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）

贡献

欢迎在

许可证

麻省理工学院