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 壁纸获取随机壁纸

开发指南

安装依赖

npm install

开发模式

npm run dev

构建项目

npm run build

启动服务

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: 运行时类型验证