Servidor PeakMojo

Una implementación de servidor Python para integrarse con la API de PeakMojo.

Características

Integración completa con los puntos finales de la API de PeakMojo
Autenticación de token de portador
Acceso a la funcionalidad de PeakMojo basado en recursos y herramientas
Retorno automático a respuestas simuladas durante el desarrollo

Instalación

pip install mcp-server-peakmojo

Configuración

El servidor requiere las siguientes variables de entorno:

PEAKMOJO_API_KEY : Su clave API de PeakMojo para autenticación
PEAKMOJO_BASE_URL (opcional): URL base de la API de PeakMojo (el valor predeterminado es https://api.staging.readymojo.com )

También puedes configurarlos mediante argumentos de la línea de comando:

python -m mcp_server_peakmojo --api-key YOUR_API_KEY --base-url YOUR_BASE_URL

Recursos disponibles

El servidor proporciona acceso a los siguientes recursos de PeakMojo:

Usuarios ( peakmojo://users )
Personas ( peakmojo://personas , peakmojo://personas/tags , peakmojo://personas/search )
Escenarios ( peakmojo://scenarios )
Escenarios de trabajo ( peakmojo://job_scenarios )
Empleos ( peakmojo://jobs )
Aplicaciones ( peakmojo://applications )
Prácticas ( peakmojo://practices )
Habilidades ( peakmojo://skills )
Certificados ( peakmojo://certificates )

Herramientas disponibles

El servidor proporciona las siguientes herramientas para interactuar con la API de PeakMojo:

Gestión de usuarios

get_peakmojo_users : Obtener la lista de todos los usuarios
get_peakmojo_user : Obtener detalles del usuario por ID
get_peakmojo_user_stats : Obtener estadísticas de usuario
update_peakmojo_user_stats : Actualizar las estadísticas del usuario

Gestión de personas

get_peakmojo_personas : Obtener lista de personas
get_peakmojo_persona_tags : Obtener etiquetas de persona
search_peakmojo_personas : Búsqueda de personas
create_peakmojo_persona : Crea una nueva persona

Gestión de escenarios

get_peakmojo_scenarios : Obtener lista de escenarios
create_peakmojo_job_scenario : Crea un nuevo escenario de trabajo

Gestión del espacio de trabajo

get_workspace_personas : Obtener personas para un espacio de trabajo

Gestión de trabajos

get_job : Obtener detalles del trabajo

Gestión de aplicaciones

get_application : Obtener detalles de la aplicación

Gestión de la práctica

get_practice_messages : Obtener mensajes de práctica

Gestión de habilidades

get_user_skills : Obtener las habilidades del usuario

Gestión de certificados

get_certificates : Obtener la lista de certificados
get_certificate_skills : Obtener habilidades para un certificado
issue_user_certificate : Emitir un certificado a un usuario
add_certificate_skill_courses : Agregar cursos a una habilidad de certificado

Desarrollo

Durante el desarrollo, si la API no es accesible, el servidor recurrirá automáticamente a respuestas simuladas para cada endpoint. Esto permite el desarrollo y las pruebas sin necesidad de una conexión a la API activa.

Manejo de errores

El servidor implementa un manejo integral de errores:

Las claves API no válidas se registran con advertencias
Las solicitudes de API fallidas recurren a respuestas simuladas
Los errores HTTP se detectan y registran correctamente
Todos los errores se devuelven como respuestas JSON con mensajes de error apropiados.

Soporte de Docker

Prerrequisitos

La imagen de Docker está diseñada para múltiples plataformas:

Linux/amd64
Linux/arm64
Linux/arm/v7

Opción 1: Extraer desde Docker Hub

docker pull buryhuang/mcp-server-peakmojo:latest

Opción 2: Construir localmente

docker build -t mcp-server-peakmojo .

Ejecución del contenedor

Uso básico con clave API:

docker run \
  -e PEAKMOJO_API_KEY=your_api_key_here \
  -e PEAKMOJO_BASE_URL=https://api.staging.readymojo.com \
  buryhuang/mcp-server-peakmojo:latest

Publicación multiplataforma

Para publicar la imagen de Docker para múltiples plataformas:

Cree una nueva instancia de constructor (si aún no lo ha hecho):
docker buildx create --use
Construya y envíe la imagen para múltiples plataformas:
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t peakmojo/mcp-server-peakmojo:latest --push .
Verifique que la imagen esté disponible para las plataformas especificadas:
docker buildx imagetools inspect peakmojo/mcp-server-peakmojo:latest

Uso con Claude Desktop

Configure el servidor MCP en la configuración de Claude Desktop:

{
  "mcpServers": {
    "peakmojo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PEAKMOJO_API_KEY=your_api_key_here",
        "-e",
        "PEAKMOJO_BASE_URL=https://api.staging.readymojo.com",
        "peakmojo/mcp-server-peakmojo:latest"
      ]
    }
  }
}

Ejemplo ejecutándose desde la fuente

Si desea ejecutar directamente desde el código fuente:

{
  "mcpServers": {
    "peakmojo": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_peakmojo",
        "--api-key",
        "your_api_key_here",
        "--base-url",
        "https://api.staging.readymojo.com"
      ]
    }
  }
}

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

PeakMojo Server

Integrations