MCP Test Server

MCP 测试项目

这是一个基于 Model Context Protocol (MCP) TypeScript SDK 的测试项目，用于演示和测试 MCP 的不同机制，包括 Resources、Tools 和 Prompts。

项目特性

📄 Resources (资源)

用户列表 (test://users) - 获取所有用户数据
待办事项 (test://todos) - 获取所有待办事项数据
配置信息 (test://config) - 系统配置信息
系统日志 (test://logs) - 查看系统操作日志

🔧 Tools (工具)

add_user - 添加新用户
search_users - 搜索用户（支持按姓名、邮箱和角色筛选）
create_todo - 创建待办事项
calculate - 执行数学计算（支持表达式和基本运算）

💬 Prompts (提示模板)

user_analysis - 用户数据分析提示
todo_summary - 待办事项摘要提示
system_report - 系统状态报告提示
code_review - 代码审查提示模板

快速开始

1. 安装依赖

npm install

2. 构建项目

npm run build

3. 启动 MCP 服务器

npm start

4. 运行测试客户端

在另一个终端中运行：

npm test

项目结构

mcp-test-project/
├── src/
│   ├── index.ts          # MCP 服务器主文件
│   └── test-client.ts    # 测试客户端
├── dist/                 # 编译后的文件
├── package.json
├── tsconfig.json
└── README.md

使用示例

Resources 示例

// 列出所有资源
const resources = await client.listResources();

// 读取用户资源
const usersResource = await client.readResource({ 
  uri: "test://users" 
});

Tools 示例

// 添加用户
const result = await client.callTool({
  name: "add_user",
  arguments: {
    name: "张三",
    email: "zhangsan@example.com",
    role: "admin"
  }
});

// 计算
const calcResult = await client.callTool({
  name: "calculate",
  arguments: {
    expression: "10 + 5 * 2"
  }
});

Prompts 示例

// 获取用户分析提示
const userAnalysis = await client.getPrompt({
  name: "user_analysis",
  arguments: {
    user_id: "1",
    analysis_type: "detailed"
  }
});

// 获取代码审查提示
const codeReview = await client.getPrompt({
  name: "code_review",
  arguments: {
    language: "typescript",
    code_snippet: "function hello() { return 'world'; }",
    focus_areas: "代码质量、性能"
  }
});

测试数据

项目包含以下测试数据：

用户数据

[
  { "id": 1, "name": "张三", "email": "zhangsan@example.com", "role": "admin" },
  { "id": 2, "name": "李四", "email": "lisi@example.com", "role": "user" },
  { "id": 3, "name": "王五", "email": "wangwu@example.com", "role": "user" }
]

待办事项数据

[
  { "id": 1, "title": "完成MCP测试项目", "completed": false, "userId": 1 },
  { "id": 2, "title": "学习TypeScript", "completed": true, "userId": 2 },
  { "id": 3, "title": "测试MCP功能", "completed": false, "userId": 1 }
]

开发脚本

npm run build - 编译 TypeScript 代码
npm start - 启动 MCP 服务器
npm run dev - 构建并启动服务器
npm test - 运行测试客户端
npm run clean - 清理构建文件

MCP 协议说明

Model Context Protocol (MCP) 是一个标准化协议，用于在大型语言模型和外部数据源/工具之间建立安全、可控的连接。

核心概念

Resources - 静态数据或文档，模型可以读取但不能修改
Tools - 模型可以调用的函数，用于执行操作或获取动态数据
Prompts - 可重用的提示模板，支持参数化

技术栈

TypeScript - 主要编程语言
MCP TypeScript SDK - MCP 协议实现
Node.js - 运行时环境

许可证

MIT License

参考链接

This server cannot be installed

security - not tested

license - not found

quality - not tested

A testing server that demonstrates Model Context Protocol features, providing access to user data, todos, and system information through resources, tools for user management and calculations, and prompt templates for various analyses.

Related MCP Servers

Nextflow Developer Tools MCP
adamrtalbot
-
security
F
license
-
quality
A Model Context Protocol server designed to facilitate Nextflow development and testing, providing tools for building from source, running tests, and managing the Nextflow development environment.
Last updated -
Python
Qase MCP Server
RayYokoyama
-
security
F
license
-
quality
A Model Context Protocol server that integrates with the Qase test management platform, allowing users to create and retrieve test cases, manage test runs, and interact with Qase projects.
Last updated -
1
JavaScript
MCP Everything
s2005
-
security
A
license
-
quality
A test server implementing all features of the MCP protocol, including prompts, tools, resources, and sampling, designed for testing MCP clients rather than practical applications.
Last updated -
Python
MIT License
CyberMCP
ricauts
-
security
A
license
-
quality
A Model Context Protocol server designed for testing backend APIs for security vulnerabilities like authentication bypass, injection attacks, and data leakage.
Last updated -
5
TypeScript
MIT License

View all related MCP servers