Faker MCP Server

🚀 假人服务器 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，借助 Faker.js 生成假数据。该服务器生动展示了 MCP 的核心概念，主要解决了在开发和测试过程中需要大量假数据的问题，为开发者提供了便捷、多样且可定制的假数据生成方案，其价值显著。具体涵盖以下方面：

• 具备生成多种类型假数据的工具，如人物、lorem ipsum、互联网相关等数据。
• 支持多种本地化语言，满足不同地区的使用需求。
• 每种数据类型都能进行自定义选项设置，灵活性高。

✨ 主要特性

工具

• generate_person：可生成假人数据，包含姓名、职位等信息。
• generate_lorem：用于生成 lorem ipsum 假文本。
• generate_internet：能生成互联网相关的假数据，像电子邮件、用户名、URL 等。
• generate_date：可生成假日期。
• generate_commerce：生成商务相关的假数据，例如产品、价格等。
• 此外，还包含 Faker.js 中的众多其他模块。

功能

• 支持多种本地化语言，如英语（en）、日语（ja）、法语（fr）等。
• 每种数据类型都能自定义字段选择，满足个性化需求。
• 可配置参数，如长度、数量、最小/最大值等。

📦 安装指南

开发环境依赖安装

安装项目所需的依赖：

npm install

服务器构建

构建服务器：

npm run build

开发模式自动重建

在开发模式下实现自动重建：

npm run watch

测试相关操作

运行所有测试

npm test

运行带有观察的测试

npm run test:watch

运行特定的集成测试

npm run test:integration

生成测试覆盖率报告

npm run test:coverage

在 Claude Desktop 中使用的安装步骤

要在 Claude Desktop 中使用该服务器，需添加服务器配置：

• 在 MacOS 上：配置文件路径为 ~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：配置文件路径为 %APPDATA%/Claude/claude_desktop_config.json

配置文件内容如下：

{
  "mcpServers": {
    "faker-server": {
      "command": "/path/to/faker-server/build/index.js"
    }
  }
}

调试说明

由于 MCP 服务器通过标准输入输出进行通信，调试工作可能具有一定挑战性。我们推荐使用 MCP 检查器，它作为一个包脚本提供：

npm run inspector

检查器会生成一个可访问浏览器调试工具的 URL，方便开发者进行调试。