Servidor MCP MonkeyType

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a todos los puntos finales de la API MonkeyType . El servidor expone herramientas MCP que permiten que los Modelos de Lenguaje Grandes (LLM) interactúen con la API MonkeyType.

Características

Expone todos los puntos finales de la API de MonkeyType como herramientas MCP
Compatible con cualquier LLM que admita el Protocolo de Contexto de Modelo
Autenticación simple basada en clave API por llamada a la herramienta
Manejo integral de errores
Conciencia del límite de velocidad (respeta los límites de velocidad de MonkeyType)

Instalación

Uso de npx (recomendado)

La forma más sencilla de ejecutar el servidor es usando npx:

npx monkeytype-mcp

Esto descargará y ejecutará la última versión del servidor directamente.

Instalación global

También puedes instalar el paquete globalmente:

npm install -g monkeytype-mcp
monkeytype-mcp

Instalación manual

Si prefieres clonar el repositorio:

git clone https://github.com/CodeDreamer06/MonkeytypeMCP.git
cd MonkeytypeMCP
npm install
npm start

Herramientas disponibles

El servidor expone los siguientes puntos finales de API MonkeyType como herramientas MCP:

Herramientas de usuario

check_username - Comprueba si un nombre de usuario está disponible
get_personal_bests - Obtener las mejores marcas personales del usuario
get_tags - Obtener las etiquetas del usuario
get_stats - Obtener las estadísticas del usuario
get_profile - Obtener el perfil del usuario
send_forgot_password_email - Enviar correo electrónico de contraseña olvidada
get_current_test_activity - Obtener la actividad de prueba actual
get_streak - Obtener la racha del usuario

Herramientas de resultados de pruebas

get_results - Obtenga hasta 1000 resultados de pruebas
get_result_by_id - Obtener resultado por ID
get_last_result - Obtener el último resultado

Herramientas públicas

get_speed_histogram - Obtener histograma de velocidad
get_typing_stats - Obtener estadísticas de mecanografía

Herramientas de tablas de clasificación

get_leaderboard - Obtener la tabla de clasificación
get_leaderboard_rank - Obtener la clasificación en la tabla de clasificación
get_daily_leaderboard - Obtener la tabla de clasificación diaria
get_weekly_xp_leaderboard - Obtener la tabla de clasificación semanal de XP

Herramientas de anuncios de servicio público

get_psas - Obtener anuncios de servicio público

Herramientas de cotizaciones

is_submission_enabled - Verifica si el envío de cotizaciones está habilitado

Herramientas de configuración del servidor

get_configuration - Obtener la configuración del servidor

Cómo obtener tu clave API de MonkeyType (ApeKey)

Para obtener su propia clave API de MonkeyType (ApeKey), siga estos pasos:

Inicie sesión en su cuenta de MonkeyType
Haz clic en el icono de tu perfil en la esquina superior derecha.
Seleccione "Cuenta" en el menú desplegable.
Vaya a la pestaña "Ape Keys"
Haga clic en "Generar nuevo" para crear una nueva clave API
Dale un nombre a tu clave (por ejemplo, "Servidor MCP")
Seleccione los ámbitos adecuados en función de los puntos finales a los que necesita acceder
Haga clic en "Generar"
Copiar la clave generada

Importante : mantenga su clave API segura y nunca la comparta públicamente.

Uso del servidor MCP con LLM

Para usar este servidor con un LLM, deberá configurar el LLM para que use este servidor para las llamadas a herramientas MCP. Debe proporcionar su clave API de MonkeyType (ApeKey) configurando la variable de entorno MONKEYTYPE_API_KEY en la configuración de su servidor MCP.

Variables de entorno

MONKEYTYPE_API_KEY : (Obligatorio) Tu clave API de MonkeyType. Puedes obtenerla en la configuración de tu cuenta en monkeytype.com.
MONKEYTYPE_USERNAME : (Opcional) Su nombre de usuario o UID de MonkeyType. Ciertas herramientas (como get_profile ) pueden usarlo por defecto o al usar palabras clave específicas.

Ejemplo de llamada a herramienta

{
  "name": "get_configuration",
  "arguments": {}
}

Integración con plataformas LLM

Para integrar este servidor con plataformas LLM como OpenAI, Anthropic u otras:

Inicie el servidor MCP utilizando uno de los métodos de instalación anteriores
Configure su plataforma LLM para utilizar este servidor como proveedor de herramientas MCP
Pasar el stdio del servidor como canal de comunicación

Integración IDE

Configuración de MCP

Para agregar MonkeyType MCP a su IDE, agregue esto al archivo de configuración MCP de su IDE:

{
  "mcpServers": {
    "monkeytype": {
      "command": "sh",
      "args": ["-c", "cd $(mktemp -d) && npm install monkeytype-mcp && npx monkeytype-mcp"],
      "env": {
        "MONKEYTYPE_API_KEY": "YOUR_APE_KEY_HERE"
      }
    }
  }
}

Ubicaciones de los archivos de configuración:

Cursor: ~/.cursor/mcp.json
Windsurf: ~/.codeium/windsurf/mcp_config.json
Cline: ~/.cline/mcp_config.json
Claude: ~/.claude/mcp_config.json

Integración de VS Code

Para utilizar este servidor MCP en VS Code:

Abrir la configuración de VS Code
Buscar "Servidor MCP"
Agregue un nuevo servidor MCP con la siguiente configuración:
- Nombre: MonkeyType MCP
- Comando: npx monkeytype-mcp
- Tipo: Entrada/Salida estándar (stdio)

Herramientas disponibles

El servidor expone los siguientes puntos finales de API MonkeyType como herramientas MCP:

Herramientas de usuario

check_username - Comprueba si un nombre de usuario está disponible
get_personal_bests - Obtener las mejores marcas personales del usuario
get_tags - Obtener las etiquetas del usuario
get_stats - Obtener las estadísticas del usuario
get_profile - Obtener el perfil del usuario
send_forgot_password_email - Enviar correo electrónico de contraseña olvidada
get_current_test_activity - Obtener la actividad de prueba actual
get_streak - Obtener la racha del usuario

`get_profile`

Obtiene el perfil público de un usuario.

Parámetros:

uidOrName (cadena, opcional): el UID o nombre de usuario del usuario cuyo perfil se desea obtener.
- Si proporciona un nombre de usuario o UID específico, se obtendrá el perfil de ese usuario.
- Puedes usar palabras clave como "me", "self", "current" o "my". Si se usa alguna de estas palabras clave, la herramienta usará la variable de entorno MONKEYTYPE_USERNAME (si está configurada).
- Si este parámetro se omite por completo, la herramienta también intentará utilizar la variable de entorno MONKEYTYPE_USERNAME (si está configurada).
- Si se omite el parámetro uidOrName (o se utiliza una palabra clave) y no se establece la variable de entorno MONKEYTYPE_USERNAME , se producirá un error.

Herramientas de resultados de pruebas

get_results - Obtenga hasta 1000 resultados de pruebas
get_result_by_id - Obtener resultado por ID
get_last_result - Obtener el último resultado

Herramientas públicas

get_speed_histogram - Obtener histograma de velocidad
get_typing_stats - Obtener estadísticas de mecanografía

Herramientas de tablas de clasificación

get_leaderboard - Obtener la tabla de clasificación
get_leaderboard_rank - Obtener la clasificación en la tabla de clasificación
get_daily_leaderboard - Obtener la tabla de clasificación diaria
get_weekly_xp_leaderboard - Obtener la tabla de clasificación semanal de XP

Herramientas de anuncios de servicio público

get_psas - Obtener anuncios de servicio público

Herramientas de cotizaciones

is_submission_enabled - Verifica si el envío de cotizaciones está habilitado

Herramientas de configuración del servidor

get_configuration - Obtener la configuración del servidor

Publicación

Si está realizando cambios en este servidor y desea publicar su propia versión:

npm login
npm publish

Repositorio de GitHub

Este proyecto está alojado en GitHub en https://github.com/CodeDreamer06/MonkeytypeMCP .

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

MonkeyType para proporcionar la API
Protocolo de contexto de modelo (MCP) para la arquitectura del servidor

Descargo de responsabilidad

Este proyecto no está afiliado oficialmente a MonkeyType. Úselo bajo su propia responsabilidad y asegúrese de cumplir con los términos de servicio y los límites de velocidad de la API de MonkeyType.

Integrations