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: mcp-rando-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

Licencia

Instituto Tecnológico de Massachusetts (MIT)