MCP 服务器

MCP Test Server

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.

README

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 }
]