A simple MCP Server

一个简单的 MCP 服务

一个提供用户数据管理工具的模型上下文协议（MCP）服务实现。

功能

• 用户数据检索工具
• TypeScript 实现
• 支持 ES Modules
• 内置 TypeScript 编译

前置条件

• Node.js（v20 或更高版本）
• npm（v9 或更高版本）

安装

1. 克隆仓库：

git clone https://github.com/fujahgabriel/simple-mcp-server.git
cd simple-mcp-server

2. 安装依赖：

npm install

开发

构建项目

构建 TypeScript 文件：

npm run build

此操作将：

• 将 TypeScript 文件编译为 JavaScript
• 将文件输出到 build 目录
• 为输出文件设置正确的权限

开发模式

监视更改并自动重新构建：

npm run watch

使用 MCP Inspector

检查和测试 MCP 服务工具：

1. 首先构建项目：

npm run build

2. 启动 MCP Inspector：

npm run inspector

3. Inspector 将在 http://localhost:5173 上运行

MCP 配置

要将此 MCP 服务与 Cursor 配合使用，需要在 MCP 设置中进行配置。将以下配置添加到 ~/.cursor/mcp.json：

{
  "my-mcp-server": {
    "math": {
      "command": "node",
      "args": ["build/index.js"]
    }
  }
}

请确保：

1. 先使用 npm run build 构建项目
2. 使用构建后 JavaScript 文件的正确路径
3. 更新配置后重启 Cursor

可用工具

get_users

检索所有用户的列表。

get_user

按名称检索特定用户。

参数：

• user：string - 要检索的用户名称

项目结构

mcp-server/
├── build/           # Compiled JavaScript files
├── index.ts         # Main server implementation
├── package.json     # Project dependencies and scripts
└── tsconfig.json    # TypeScript configuration

依赖项

• @modelcontextprotocol/sdk：用于实现服务的 MCP SDK
• dotenv：环境变量管理
• typescript：TypeScript 编译器
• zod：运行时类型验证

许可证

MIT