Bookeo MCP

Bookeo MCP服务器

MCP（模型上下文协议）服务器，用于从以下位置查找客户预订和付款信息 Bookeo.

特性

• 按客户姓名或电子邮件搜索预订
• 按预订号查找特定预订
• 搜索日期范围内的预订
• 通过手动与Stripe支付检测获取付款详细信息

先决条件

• Python 3.10+
• Bookeo API凭证（API密钥和密钥）

安装

1. 克隆存储库并创建虚拟环境：

cd bookeo
python3 -m venv .venv
source .venv/bin/activate

1. 安装软件包：

pip install -e .

使用Claude代码进行配置

使用 claude mcp add （推荐）

claude mcp add --transport stdio bookeo \
  -e API_KEY=your_bookeo_api_key \
  -e API_SECRET=your_bookeo_secret_key \
  -- /path/to/bookeo/.venv/bin/python -m bookeo_mcp.server

替换 /path/to/bookeo 带有项目目录的实际路径。

使用 .mcp.json

或者，添加到您的 .mcp.json 文件（项目特定的项目目录，或 ~/.claude/.mcp.json 全球）：

{
  "mcpServers": {
    "bookeo": {
      "type": "stdio",
      "command": "/path/to/bookeo/.venv/bin/python",
      "args": ["-m", "bookeo_mcp.server"],
      "cwd": "/path/to/bookeo",
      "env": {
        "API_KEY": "your_bookeo_api_key",
        "API_SECRET": "your_bookeo_secret_key"
      }
    }
  }
}

注： 如果使用 .mcp.json，您也可以将凭据存储在 .env 将文件放在项目目录中，而不是配置中。

可用工具

搜索_预订_客户

按客户姓名或电子邮件搜索预订。

• customer_name：完整或部分客户名称（不区分大小写）
• customer_email：完整或部分电子邮件地址（不区分大小写）
• days_back：返回搜索的天数（默认90天，最多365天）

get_booking

通过预订号查找特定预订。

• booking_number：Bookeo预订号

搜索_预订_日期

查找日期范围内的所有预订。

• start_date：YYYY-MM-DD格式的开始日期
• end_date：YYYY-MM-DD格式的结束日期
• include_canceled：是否包括已取消的预订（默认为false）

获取_预订_付款

获取特定预订的付款详细信息。

• booking_number：Bookeo预订号

返回付款明细，包括方法、金额以及付款是手动还是通过Stripe。

独立运行

stdio传输（默认）

bookeo-mcp

苏格兰和南方能源公司运输

对于网络可访问的部署，请使用SSE传输：

bookeo-mcp --transport sse --host 0.0.0.0 --port 8000

选项：

• --transport: stdio （默认）或 sse
• --host：要绑定的主机（默认值： 127.0.0.1)
• --port：要侦听的端口（默认值： 8000)

码头工人

使用预构建图像

docker pull ghcr.io/fdstevex/bookeo-mcp:latest

docker run -p 8000:8000 \
  -e API_KEY=your_bookeo_api_key \
  -e API_SECRET=your_bookeo_secret_key \
  ghcr.io/fdstevex/bookeo-mcp:latest

在当地建设

docker build -t bookeo-mcp .

docker run -p 8000:8000 \
  -e API_KEY=your_bookeo_api_key \
  -e API_SECRET=your_bookeo_secret_key \
  bookeo-mcp

默认情况下，Docker镜像在端口8000上使用SSE传输运行。

使用SSE配置Claude代码

要将Claude Code连接到SSE MCP服务器，请执行以下操作：

claude mcp add --transport sse bookeo http://localhost:8000/sse

或在 .mcp.json:

{
  "mcpServers": {
    "bookeo": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}