Servidor MCP de RandomUser

Un servidor MCP que proporciona acceso mejorado a la API randomuser.me con características adicionales como formato personalizado, generación de contraseñas y distribución ponderada de nacionalidad.

Instalación

Clonar el repositorio:

git clone https://github.com/rycid/randomuserMCP.git
cd randomuserMCP

# Install dependencies
npm install

# Build the project
npm run build

Related MCP server: ntropy-mcp MCP Server

Uso

Agregue a su archivo de configuración de MCP ( claude_desktop_config.json o cline_mcp_settings.json ):

{
  "mcpServers": {
    "randomuser": {
      "command": "node",
      "args": ["path/to/randomuserMCP/build/index.js"]
    }
  }
}

Herramientas disponibles

obtener_usuario_aleatorio

Obtenga un único usuario aleatorio con opciones personalizables.

{
  "gender": "female",
  "nationality": "US",
  "fields": {
    "mode": "include",
    "values": ["name", "email", "phone"]
  },
  "format": {
    "type": "json",
    "structure": {
      "flattenObjects": true,
      "nameFormat": "full"
    }
  },
  "password": {
    "charsets": ["special", "upper", "lower", "number"],
    "minLength": 8,
    "maxLength": 12
  }
}

obtener_múltiples_usuarios

Obtenga múltiples usuarios aleatorios con distribución de nacionalidad ponderada.

{
  "count": 10,
  "nationality": ["US", "GB", "FR"],
  "nationalityWeights": {
    "US": 0.5,
    "GB": 0.3,
    "FR": 0.2
  },
  "fields": {
    "mode": "include",
    "values": ["name", "email", "nat"]
  },
  "format": {
    "type": "csv",
    "csv": {
      "delimiter": ",",
      "includeHeader": true
    }
  }
}

Formatos de salida

El servidor admite múltiples formatos de salida:

JSON (predeterminado)

Objetos anidados o aplanados
Formatos de nombre personalizables (completo, nombre_apellido, separado)
Opciones de formato de fecha (iso, unix, formateada)

CSV

Delimitador personalizable
Encabezados opcionales
Estructura de datos aplanada automáticamente

SQL

Compatibilidad con múltiples dialectos (MySQL, PostgreSQL, SQLite)
Sentencias CREATE TABLE opcionales
Escape y manejo de tipos adecuados

XML

Formato XML estándar
Estructura de datos anidada
Escape adecuado de caracteres especiales

Selección de campo

Incluir o excluir campos específicos:

{
  "fields": {
    "mode": "include",  // or "exclude"
    "values": [
      "name",
      "phone",
      "email",
      "location",
      "picture",
      "dob",
      "login",
      "registered",
      "id",
      "cell",
      "nat"
    ]
  }
}

Nacionalidades admitidas

AU: Australia
BR: Brasil
CA: Canadá
CH: Suiza
DE: Alemania
DK: Dinamarca
ES: España
FI: Finlandia
FR: Francia
GB: Reino Unido
IE: Irlanda
EN: India
IR: Irán
MX: México
NL: Países Bajos
NO: Noruega
NZ: Nueva Zelanda
RS: Serbia
TR: Turquía
UA: Ucrania
EE.UU.: Estados Unidos

Desarrollo

# Install dependencies
npm install

# Build the project
npm run build

# Start in development mode (with watch mode)
npm run dev

# Start the server
npm start