# MCP Project Query Server

一个基于 Model Context Protocol (MCP) 的项目查询服务器，采用 TypeScript 开发，具有 Spring Boot 风格的目录结构。

## 项目结构

```
mcp-demo/
├── src/
│   ├── main/
│   │   ├── controllers/     # 控制器层 - 处理MCP工具调用
│   │   │   ├── ProjectController.ts
│   │   │   └── WallpaperController.ts
│   │   ├── services/        # 服务层 - 业务逻辑处理
│   │   │   ├── ProjectService.ts
│   │   │   └── WallpaperService.ts
│   │   ├── repositories/    # 数据访问层 - 数据持久化
│   │   │   └── ProjectRepository.ts
│   │   ├── models/          # 数据模型 - 接口定义
│   │   │   └── Project.ts
│   │   ├── config/          # 配置类
│   │   │   └── AppConfig.ts
│   │   └── index.ts         # 主入口文件
│   └── resources/           # 资源文件
│       └── projects.json    # 项目数据
├── dist/                    # 构建输出目录
├── package.json
├── rollup.config.mjs
└── tsconfig.json
```

## 功能特性

### 项目管理功能
- `get_project_info`: 根据项目名称查询项目信息
- `get_project_count`: 获取项目总数
- `get_project_all`: 获取所有项目列表
- `add_project`: 新增项目

### 壁纸功能
- `get_random_wallpaper`: 从 Bing 壁纸获取随机壁纸

## 开发指南

### 安装依赖
```bash
npm install
```

### 开发模式
```bash
npm run dev
```

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

### 启动服务
```bash
npm start
```

### 构建输出
构建完成后，`dist` 目录将包含：
```
dist/
├── index.js              # 统一的 CommonJS 入口文件
└── resources/            # 复制的资源文件
    └── projects.json     # 项目数据文件
```

## 架构设计

本项目采用分层架构设计，参考 Spring Boot 的目录结构：

1. **Controller 层**: 负责处理 MCP 工具调用，参数验证和响应格式化
2. **Service 层**: 包含业务逻辑，处理具体的业务需求
3. **Repository 层**: 负责数据访问和持久化
4. **Model 层**: 定义数据结构和接口
5. **Config 层**: 管理应用配置

这种设计提供了良好的代码组织、可维护性和可扩展性。

## 技术栈

- **TypeScript**: 提供类型安全和更好的开发体验
- **Rollup**: 模块打包工具
- **MCP SDK**: Model Context Protocol 开发工具包
- **Zod**: 运行时类型验证