Wordle MCP

Obtiene las soluciones diarias de Wordle para una fecha específica a través de la API de Wordle.

GitHub
2

Documentación

Wordle MCP (Python)

CI Open in GitHub Codespaces Ask DeepWiki

[!NOTE] Para ver la versión Go de este servidor MCP (más ligera y rápida), haz clic aquí

Un servidor MCP para obtener las soluciones de Wordle a través de la API de Wordle.

[!IMPORTANT] Las soluciones de Wordle solo están disponibles desde el 2021-05-19 hasta 23 días en el futuro.
Cualquier otro intento de consultar otras fechas devolverá un error de la API

Índice

Primeros pasos

Usando Docker (recomendado)

Asegúrate de tener Docker instalado.
Añade esto a la configuración de tu servidor MCP:

{
  "mcpServers": {
    "Wordle MCP (Python)": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "ghcr.io/cr2007/mcp-wordle-python:latest"
      ]
    }
  }
}

[!IMPORTANT]
Si recibes un error en Claude Desktop la primera vez, asegúrate de extraer la imagen antes de ejecutarlo.
docker pull ghcr.io/cr2007/mcp-wordle-python:latest

Instalación mediante uvx

El método más rápido y sencillo para empezar. Asegúrate de instalar uv antes de añadir esto a tu configuración.
Añade esto a la configuración de tu servidor MCP:

{
  "mcpServers": {
    "Wordle MCP (Python)":{
      "command": "uvx",
        "args": [
          "--from",
          "git+https://github.com/cr2007/mcp-wordle-python",
          "mcp-wordle"
        ]
      }
  }
}

Ejemplos en Claude Desktop

Desarrollo

Consulta CONTRIBUTING.md para configurar un entorno de desarrollo y ejecutar la suite de pruebas. Cada push y pull request se valida mediante el flujo de CI.

Publicación de versiones

Las versiones se publican enviando una etiqueta vMAJOR.MINOR.PATCH:

  1. Incrementa version en pyproject.toml para que coincida con la nueva versión.
  2. Confirma ese cambio.
  3. Etiqueta el commit, p. ej. git tag v1.2.3 y git push origin v1.2.3.

El flujo de publicación rechaza la versión si la etiqueta no coincide con la versión de pyproject.toml, o si fallan las comprobaciones de test/uvx/Docker. En caso de éxito, envía ghcr.io/cr2007/mcp-wordle-python etiquetado con la versión completa, major.minor, major y latest.

Contribuciones

¡Las contribuciones son bienvenidas! Puedes hacer un fork del repositorio, crear tus cambios en una rama y luego crear un Pull Request

Consulta CONTRIBUTING.md para obtener una guía completa sobre cómo configurar un entorno de desarrollo, ejecutar pruebas y las convenciones de commits/PR.