# Custom Context MCP Server

基于FastMCP框架的MCP服务器，支持SSE实时事件流和工具调用。

## 功能特性

- ✅ 基于FastMCP框架
- ✅ SSE实时事件流
- ✅ HTTP健康检查端点
- ✅ 支持mcp-inspector调试
- ✅ TypeScript类型安全
- ✅ 热重载开发模式

## 快速开始

### 安装依赖

```bash
pnpm install
```

### 开发模式

```bash
# 启动开发服务器（包含mcp-inspector）
pnpm run dev

# 或者启动监听模式
pnpm run dev:watch
```

### 生产模式

```bash
# 构建项目
pnpm run build

# 启动服务器
pnpm start
```

## 调试指南

### 使用mcp-inspector调试

1. **启动服务器**：
   ```bash
   pnpm run dev
   ```

2. **访问mcp-inspector**：
   - 服务器启动后会自动打开mcp-inspector界面
   - 或者手动访问：http://localhost:6274

3. **测试工具**：
   - 在mcp-inspector中选择工具
   - 输入参数并执行
   - 查看实时结果

### 服务器端点

- **SSE端点**: `http://localhost:3005/sse`
- **健康检查**: `http://localhost:3005/health`
- **mcp-inspector**: `http://localhost:6274`

### 测试工具

#### group-text-by-json
```json
{
  "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}"
}
```

#### text-to-json
```json
{
  "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}",
  "text": "name: John Doe\nage: 25\ncity: Beijing"
}
```



## 项目结构

```
src/
├── common/
│   ├── constants.ts    # 常量定义
│   ├── tools.ts        # 工具实现
│   ├── types.ts        # 类型定义
│   └── utils.ts        # 工具函数
└── index.ts           # 主入口文件
```

## 工具功能

### 1. group-text-by-json
根据JSON模板生成文本分组提示词，帮助AI将文本按模板结构分组。

### 2. text-to-json
将分组文本转换为JSON格式，基于原始模板结构。



## 开发指南

### 添加新工具

1. 在 `src/common/types.ts` 中定义工具schema
2. 在 `src/common/tools.ts` 中实现工具逻辑
3. 在 `src/common/constants.ts` 中添加工具名称
4. 在 `src/index.ts` 中注册工具

### 调试技巧

1. **查看日志**: 服务器会输出详细的日志信息
2. **SSE连接**: 可以通过浏览器访问SSE端点查看实时事件
3. **健康检查**: 访问健康检查端点确认服务器状态
4. **热重载**: 开发模式下支持代码热重载

### 常见问题

#### 端口被占用
```bash
# 检查端口占用
lsof -i :3005
lsof -i :6274
```

#### 构建错误
```bash
# 清理并重新构建
rm -rf build/
pnpm run build
```

#### 依赖问题
```bash
# 重新安装依赖
pnpm install
```

## 技术栈

- **FastMCP**: MCP协议实现框架
- **Express**: HTTP服务器和中间件
- **TypeScript**: 类型安全
- **SSE**: 服务器发送事件
- **Zod**: 数据验证

## 许可证

ISC