mcpField
L
Lodgify MCP Server

Lodgify MCP Server

本地服务
github.com/shanephall地图与出行268 周前更新

关于 Lodgify MCP Server

Lodgify MCP Server 将 MCP 客户端连接到 Lodgify 度假租赁 API,供用户通过专用工具管理房源、预订和日历数据。

主要功能

  1. 01获取房源及房源详情
  2. 02获取预订及预订详情
  3. 03创建预订
  4. 04更新预订状态
  5. 05获取日历数据

适用场景

  1. 01查看度假租赁房源
  2. 02查找预订记录
  3. 03创建预订并更改状态
  4. 04检查日历数据

MCP 相关

将 Lodgify 的房源、预订和日历操作作为工具提供给 MCP 客户端。通过 LODGIFY_API_KEY 环境变量访问 API。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"lodgify": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"pull"
]
}
}
}
启动命令docker run -i --rm pull

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
ocipull

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Lodgify MCP 服务

一个用于 Lodgify 度假租赁 API 的模型上下文协议(MCP)服务。它提供用于管理房源、预订和日历数据的工具。

快速开始

使用 uv 安装依赖,并使用 uvx 运行服务:

export LODGIFY_API_KEY=your_api_key
uvx lodgify-mcp-server

从源代码运行:

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

Claude Desktop 配置

将此代码块添加到 Claude Desktop 配置中(请参阅 examples/ 文件夹中的示例):

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

可用工具

  • 房源:get_properties、get_property_by_id
  • 预订:get_bookings、get_booking_by_id、create_booking、update_booking_status
  • 日历:get_calendar

故障排除

  • 确保已设置 LODGIFY_API_KEY 环境变量。
  • 遇到 spawn uvx ENOENT?请从 astral.sh/uv 安装 uv,然后重启 shell。

安全

同步依赖后,运行 pip-audit 检查已知漏洞。uv.lock 文件将 starlette 固定在 0.47.0 版本,以解决上游安全公告中指出的问题。

贡献

请参阅 CONTRIBUTING.md,了解开发环境设置和测试说明。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。