Skip to main content
Glama
sweetwisdom

MCP Project Query Server

by sweetwisdom

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

Related MCP server: UseScraper MCP Server

功能特性

项目管理功能

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sweetwisdom/mcp-demo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server