MCP Project Query Server

MCP Project Query Server

Enables users to manage projects and retrieve random wallpapers through a TypeScript-based MCP server. Supports project queries, creation, and Bing wallpaper retrieval with Spring Boot-style architecture.

Category
Visit Server

README

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured