Lodgify MCP Server

Servidor MCP Lodgify

Um servidor Model Context Protocol (MCP) para a API de aluguel de temporada Lodgify. Ele expõe ferramentas para gerenciar propriedades, reservas e dados de calendário.

Início rápido

Instale as dependências com uv e execute o servidor com uvx:

export LODGIFY_API_KEY=your_api_key
uvx lodgify-mcp-server

Para executar a partir do código-fonte:

git clone https://github.com/fast-transients/lodgify-mcp-server.git
cd lodgify-mcp-server
uv sync
export LODGIFY_API_KEY=your_api_key
uv run python entrypoint.py

Configuração do Claude Desktop

Adicione este bloco à sua configuração do Claude Desktop (veja exemplos na pasta examples/):

{
  "mcpServers": {
    "lodgify": {
      "command": "uvx",
      "args": ["lodgify-mcp-server"],
      "env": {
        "LODGIFY_API_KEY": "your_api_key"
      }
    }
  }
}

Ferramentas disponíveis

• Propriedades: get_properties, get_property_by_id
• Reservas: get_bookings, get_booking_by_id, create_booking, update_booking_status
• Calendário: get_calendar

Solução de problemas

• Certifique-se de que a variável de ambiente LODGIFY_API_KEY esteja definida.
• Está recebendo spawn uvx ENOENT? Instale uv de astral.sh/uv e reinicie o seu shell.

Segurança

Após sincronizar as dependências, execute pip-audit para verificar vulnerabilidades conhecidas. O arquivo uv.lock fixa starlette 0.47.0 para resolver avisos upstream.

Contribuindo

Veja CONTRIBUTING.md para configuração de desenvolvimento e instruções de teste.