Lodgify MCP Server

Un servidor Model Context Protocol (MCP) per a l'API de lloguer vacacional de Lodgify. Exposa eines per a gestionar propietats, reserves i dades del calendari.

Inici ràpid

Instal·la les dependències amb uv i executa el servidor amb uvx:

export LODGIFY_API_KEY=your_api_key

uvx lodgify-mcp-server

Per executar des del codi font:

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

Configuració de Claude Desktop

Afegeix aquest bloc a la configuració de Claude Desktop (veure exemples a la carpeta examples/):

{

"mcpServers": {

"lodgify": {

"command": "uvx",

"args": ["lodgify-mcp-server"],

"env": {

"LODGIFY_API_KEY": "your_api_key"

}

}

}

}

Eines disponibles

• Properties: get_properties, get_property_by_id
• Bookings: get_bookings, get_booking_by_id, create_booking, update_booking_status
• Calendar: get_calendar

Resolució de problemes

• Assegura't que la variable d'entorn LODGIFY_API_KEY estigui configurada.
• Si apareix spawn uvx ENOENT, instal·la uv des de https://astral.sh/uv/ i reinicia la teva shell.

Seguretat

Després de sincronitzar les dependències, executa pip-audit per comprovar vulnerabilitats conegudes. El fitxer uv.lock fixa starlette 0.47.0 per abordar les avisos d'upstream.

Contribució

Consulta CONTRIBUTING.md per a instruccions sobre la configuració del desenvolupament i les proves.