# MCP对话管理服务器

一个基于Model Context Protocol (MCP)的CLI对话管理服务器，提供会话管理、历史记录、多语言支持等功能。

## 安装

### 使用npm安装

```bash
npm install mcp-conversation-server
```

### 从源码安装

```bash
git clone <repository-url>
cd mcp-conversation-server
npm install
npm run build
```

## 功能特性

- ✅ **会话管理**: 创建、切换、删除会话
- ✅ **消息记录**: 保存用户和AI的对话历史
- ✅ **搜索功能**: 基于关键词搜索历史记录
- ✅ **多语言支持**: 支持中英文界面
- ✅ **导出功能**: 支持JSON、Markdown、CSV格式导出
- ✅ **统计信息**: 会话统计和数据分析
- ✅ **MCP标准**: 符合Model Context Protocol标准

## 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 构建项目

```bash
npm run build
```

### 3. 运行服务器

```bash
npm start
```

### 4. 开发模式

```bash
npm run dev
```

## MCP工具列表

服务器提供以下MCP工具：

### 会话管理工具
- `create_session` - 创建新会话
- `list_sessions` - 列出所有会话
- `switch_session` - 切换会话
- `delete_session` - 删除会话

### 消息管理工具
- `save_message` - 保存消息
- `get_history` - 获取历史记录
- `search_messages` - 搜索消息

### 语言工具
- `set_language` - 设置语言
- `get_translation` - 获取翻译

### 导出和统计工具
- `export_history` - 导出历史记录
- `get_stats` - 获取统计信息

## 配置示例

### Claude Desktop配置

在Claude Desktop的配置文件中添加：

```json
{
  "mcpServers": {
    "conversation-manager": {
      "command": "node",
      "args": ["/path/to/mcp-conversation-server/dist/index.js"]
    }
  }
}
```

### Cursor配置

在Cursor的MCP配置中添加：

```json
{
  "mcpServers": {
    "conversation-manager": {
      "command": "node",
      "args": ["/path/to/mcp-conversation-server/dist/index.js"]
    }
  }
}
```

## API使用示例

### 创建会话

```json
{
  "name": "create_session",
  "arguments": {
    "name": "我的项目",
    "project": "project-1",
    "metadata": {
      "environment": "development"
    }
  }
}
```

### 保存消息

```json
{
  "name": "save_message",
  "arguments": {
    "role": "user",
    "content": "帮我写一个函数",
    "command": "code function"
  }
}
```

### 获取历史记录

```json
{
  "name": "get_history",
  "arguments": {
    "limit": 10,
    "format": "table"
  }
}
```

## 数据存储

服务器使用JSON文件存储数据：

- `./.mcp-conversations/sessions.json` - 会话数据
- `./.mcp-conversations/messages.json` - 消息数据

## 开发

### 项目结构

```
src/
  index.ts          # 服务器主文件
  tools.ts          # 工具定义
  conversation-manager.ts  # 对话管理器
```

### 测试

```bash
npm test
```

## 许可证

MIT License