克劳德会议经理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 interfaceGUI将在以下时间打开 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运作原理
- 会话检测：扫描
~/.claude/projects/为了.jsonl文件 - 智能解析：从第一条用户消息中提取标题，删除IDE上下文标记
- 安全删除：将已删除的会话移动到
.bak用于恢复的文件夹 - 清理逻辑：标识空会话和无效的API密钥错误
- Web服务器：带有RESTful API的基于Flask-based GUI
需求
- Python 3.10+
- 克劳德代码（用于MCP集成）
- 现代网络浏览器（用于GUI）
贡献
欢迎在
许可证
麻省理工学院