Wordle MCP

Wordle MCP (Python)

[!NOTE] Para conferir a versão em Go deste MCP Server (mais leve e rápida), clique aqui

Um MCP Server para buscar as soluções do Wordle por meio da API do Wordle.

[!IMPORTANT] As soluções do Wordle estão disponíveis apenas de 2021-05-19 até 23 dias no futuro.
Qualquer outra tentativa de consultar outras datas retornará um erro da API

Índice

• Começar
  • Usando Docker (recomendado)
  • Instalando via uvx
• Exemplos no Claude Desktop
• Desenvolvimento
  • Lançamentos
• Contribuindo

---

Começar

Usando Docker (recomendado)

Certifique-se de ter o Docker instalado.
Adicione isto à sua configuração do MCP Server:

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

[!IMPORTANT]
Se você receber um erro no Claude Desktop na primeira vez, apenas certifique-se de puxar a imagem antes de executar.
docker pull ghcr.io/cr2007/mcp-wordle-python:latest

Instalando via uvx

O método mais rápido e fácil para começar. Certifique-se de instalar o uv antes de adicionar isto à sua configuração.
Adicione isto à sua configuração do MCP server:

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

Exemplos no Claude Desktop

Desenvolvimento

Consulte CONTRIBUTING.md para configurar um ambiente de desenvolvimento e executar a suíte de testes. Cada push e pull request é validado pelo fluxo de CI.

Lançamentos

Os lançamentos são feitos ao enviar uma tag vMAJOR.MINOR.PATCH:

1. Atualize version em pyproject.toml para corresponder ao novo lançamento.
2. Faça commit dessa alteração.
3. Marque o commit com a tag, ex.: git tag v1.2.3 e git push origin v1.2.3.

O fluxo de publicação rejeita o lançamento se a tag não corresponder à versão de pyproject.toml, ou se as verificações de teste/uvx/Docker falharem. Em caso de sucesso, ele envia ghcr.io/cr2007/mcp-wordle-python marcado com a versão completa, major.minor, major e latest.

Contribuindo

Contribuições são bem-vindas! Você pode bifurcar o repositório, criar suas alterações em um branch e, em seguida, criar um Pull Request

Consulte CONTRIBUTING.md para um guia completo sobre como configurar um ambiente de desenvolvimento, executar testes e convenções de commit/PR.