my-mcp-server

一个基于 Model Context Protocol (MCP) 的示例服务，通过 stdio 方式与 MCP Client（如 Cursor 等）通信。

目前提供：

• 工具（Tool）：query_user（按用户 ID 查询用户信息）
• 资源（Resource）：docs://guide（使用指南资源，当前内容为空，可自行补充）

安装依赖

在项目根目录执行：

pnpm install

如未安装 pnpm，也可以使用 npm：

npm install

本地启动（手动）

该服务使用 stdio 传输，通常由 MCP Client 启动并托管进程；你也可以本地直接运行来观察启动日志：

node test.js

你会看到控制台输出：

• hello mcp

注意：stdio 模式下，服务会等待客户端通过标准输入与其通信；直接运行时不会有更多输出属于正常现象。

在 MCP Client 中配置

{
  "mcpServers": {
    "test": {
      "command": "npx",
      "args": ["@zengzizhao/mcp-test-server"]
    }
  }
}

能力说明

Tool: query_user

用途：查询“内置模拟数据库”中的用户信息。

• Tool 名称：query_user
• 入参：
  • userId：string，例如：001 / 002 / 003
• 返回：文本信息，包含用户的 ID / 姓名 / 邮箱 / 角色

示例

当你在 MCP Client 中提问类似：

• “帮我查一下用户 001 的信息”
• “用户 003 是谁？邮箱是什么？”

Client 可能会自动调用该工具，效果类似：

• 输入：{ "userId": "001" }
• 输出：
  • `用户信息：
    • ID: 001
    • 姓名: 张三
    • 邮箱: [email protected]
    • 角色: admin`

如果用户不存在，会返回提示：

• “用户 ID xxx 不存在。可用的 ID: 001, 002, 003”

Resource: docs://guide

用途：提供一个静态资源入口，URI 为 docs://guide。

• 资源名称：使用指南
• URI：docs://guide
• MIME：text/plain
• TEXT：MCP Server 使用指南。功能：提供用户查询等工具。使用：在 Cursor 等 MCP Client 中通过自然语言对话，Cursor 会自动调用相应工具。