使用说明（Markdown 格式）

项目简介

• 该仓库包含用于实现 MCP 服务器的服务端代码，基于 @modelcontextprotocol/sdk 的 MCP 服务框架，提供资源/会话/工具等上下文能力，通过 JSON-RPC 与 LLM 客户端进行交互。

主要功能点

• MCP 服务器端实现：注册并暴露 MCP 工具（如 list_projects、list_sessions、rename_session、delete_session 等），供 LLM 客户端调用。
• 会话与资源管理：从 Claude Code 的本地数据结构读取、整理并输出会话、项目、会话文件等信息。
• 工具执行：通过工具执行器将查询、修改等操作暴露为可调用的工具。
• 提示与摘要：支持摘要信息的渲染、移动、复制与引用，保持会话树的正确性。
• 与 Web UI 的衔接：可以启动 Web UI 服务，提供可视化管理界面。
• 传输与协议：MCP 服务器通过标准的 MCP 流/JSON-RPC 进行请求/响应，支持多种传输协议（如 Stdio），以便与 LLM 客户端协作。

安装步骤

• 安装依赖并构建：在根目录执行依赖安装与构建，确保所有包都可用。
• 启动 MCP 服务器：通过客户端命令在 Claude Code 中注册 MCP 服务器，CLI/Packaged 脚本将会启动该 MCP 服务器。
• 注册 MCP 服务器到 Claude Code 客户端配置：在 Claude Code 配置中添加 MCP 服务器信息，确保客户端可以通过 JSON-RPC 与服务器通信。

服务器配置 (MCP 客户端需要的最小信息)

• 服务器名称：claude-sessions-mcp
• 启动命令：npx
• 启动参数：["claude-sessions-mcp"]

JSON 配置示例（仅做字段说明，实际使用以 Claude Code 的配置界面为准） { "server_name": "claude-sessions-mcp", "command": "npx", "args": ["claude-sessions-mcp"] } 说明：

• server_name：在 Claude Code 中注册的服务器名称，唯一标识一个 MCP 服务实例。
• command：启动 MCP 服务所使用的命令，这里使用 npx。
• args：启动命令的参数，指向具体的 MCP 服务实现（本仓库中为 claude-sessions-mcp）。

基本使用方法

• 下载安装后启动 MCP 服务端，确保客户端能够通过 JSON-RPC 调用服务端暴露的工具。
• 客户端可通过工具如 list_projects、list_sessions、rename_session、delete_session 等进行数据查询与修改操作。
• 如需图形化管理，可启动内置的 Web UI（若需要），并通过浏览器访问进行操作。
• 服务器与客户端的协同方式遵循 MCP 规范的请求/响应模式，确保会话、资源、工具等上下文信息的安全、可扩展地提供给 LLM 客户端。

关键词 资源管理, 工具执行, 提示渲染, 会话管理, JSON-RPC

分类ID 6