# mcp-session-saver

**Repository Path**: xin-shu/mcp-session-saver

## Basic Information

- **Project Name**: mcp-session-saver
- **Description**: A Model Context Protocol service for saving session records。存储AI IDE 会话的MCP工具。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-12-16
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎉 MCP Session Saver

[English](README.md) | [简体中文](README-zh.md)

一个可以保存会话记录的MCP服务，会话内容能够保存到指定目录下，按照**IDE名称、日期、会话描述**存储为Markdown文件。

## ✨ 主要功能

- 📝 **保存会话记录** - 将 AI 对话保存为 Markdown 文件
- 📁 **智能组织** - 按 IDE/日期/描述自动分类
- 🔍 **会话管理** - 读取、搜索、删除会话
- 🌐 **多 IDE 支持** - 兼容 Qoder、Cursor、Claude Desktop、Windsurf、Trae、Codebuddy、Lingma、Continue、Aider 等

## 🚀 快速开始

### 方式1：使用 npx（推荐）

无需安装，直接在 IDE 的 MCP 配置中添加：

```json
{
  "mcpServers": {
    "session-saver": {
      "command": "npx",
      "args": ["-y", "mcp-session-saver"]
    }
  }
}
```

### 方式2：全局安装

```bash
npm install -g mcp-session-saver
```

MCP 配置：
```json
{
  "mcpServers": {
    "session-saver": {
      "command": "mcp-session-saver"
    }
  }
}
```

### 方式3：本地安装

```bash
npm install mcp-session-saver
```

## 📁 自定义存储路径（可选）

在 MCP 配置中添加环境变量：

```json
{
  "mcpServers": {
    "session-saver": {
      "command": "npx",
      "args": ["-y", "mcp-session-saver"],
      "env": {
        "MCP_SESSION_BASE_DIR": "D:\\MyProjects\\sessions"
      }
    }
  }
}
```

## 🎯 使用方法

配置完成后，在 IDE 中直接说：

```
保存当前会话
列出所有会话
搜索会话内容
```

## 📚 详细文档

- [**快速配置工具**](tools/) - 一键配置脚本
- [**详细使用指南**](docs/USAGE.md) - 完整使用说明
- [**多 IDE 配置**](docs/MULTI_IDE_SETUP.md) - Cursor、Claude 等 IDE 配置
- [**Qoder 配置**](docs/QODER_CONFIG_GUIDE.md) - Qoder 专用指南

## 🛠️ 技术栈

- JavaScript (ES Module)
- @modelcontextprotocol/sdk
- Node.js >= 16.0.0

## 📝 License

MIT

## 👏 贡献

欢迎提交 Issues 和 Pull Requests！