mcpField
D
DirectStay MCP Server

DirectStay MCP Server

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

关于 DirectStay MCP Server

DirectStay MCP Server 将 DirectStay API 的房源、预订和消息等操作提供为 MCP 工具,面向使用该 API 的集成场景。它还支持 OTP、房源比较和对话洞察提交。

主要功能

  1. 01查询房源及详情
  2. 02查询房源预订
  3. 03创建预订并更新状态
  4. 04识别来电者及 OTP 验证
  5. 05发送消息与创建房源比较
  6. 06提交对话洞察

适用场景

  1. 01查询 DirectStay 房源和预订
  2. 02创建或更新房源预订
  3. 03通过 OTP 验证来电者

MCP 相关

它向 MCP 客户端提供用于调用 DirectStay API 的工具,需要配置 DirectStay API token。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"ds": {
"command": "npx",
"args": [
"-y",
"@webdevtoday/ds-mcp-server"
]
}
}
}
启动命令npx -y @webdevtoday/ds-mcp-server

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

安装包
npm@webdevtoday/ds-mcp-server

工具

还没有获取到工具列表

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

详细介绍

DirectStay MCP 服务

一个用于与 DirectStay API 交互并提供工具的 MCP(Model Context Protocol)服务。

安装

你可以使用 npx 运行此 MCP 服务,无需在本地安装:

npx @webdevtoday/ds-mcp-server

配置

Claude Desktop

将以下内容添加到 Claude Desktop 配置中:

{
  "mcpServers": {
    "directstay": {
      "command": "npx",
      "args": ["-y", "@webdevtoday/ds-mcp-server"],
      "env": {
        "DS_TOKEN": "your_directstay_api_token_here"
      }
    }
  }
}

查找 Claude Desktop 配置的方法:

  1. 打开 Claude Desktop
  2. 前往 Settings → Developer → Edit Config

可用工具

此 MCP 服务提供以下工具,用于与 DirectStay API 交互:

  • get_all_properties - 获取所有房源的列表
  • get_property_by_id - 获取特定房源的详细信息
  • get_property_bookings - 获取特定房源的所有预订
  • create_booking - 创建新预订
  • update_booking_status - 更新现有预订的状态
  • identify_caller - 根据电话号码识别来电者
  • generate_otp - 生成一次性密码
  • verify_otp - 验证一次性密码
  • send_message - 向用户发送消息
  • create_comparison - 创建房源对比
  • submit_conversation_insights - 提交对话洞察

如需查看所有可用工具及其参数的详细信息:

npx @webdevtoday/ds-mcp-server tools

获取 DirectStay API 令牌

要使用此 MCP 服务,你需要 DirectStay API 令牌。请联系 DirectStay 获取 API 凭据。

开发

前置条件
  • Node.js(需要 v16+,建议使用 v20+)
  • npm
本地设置
  1. 克隆代码仓库
  2. 安装依赖:
    npm install
    
  3. 创建 .env 文件并填入你的 API 令牌:
    DS_TOKEN=your_directstay_api_token_here
    
  4. 运行服务:
    node mcpServer.js
    
使用 SSE(Server-Sent Events)运行
node mcpServer.js --sse
Docker 支持

使用 Docker 构建并运行:

docker build -t ds-mcp-server .
docker run -i --rm -e DS_TOKEN=your_token_here ds-mcp-server

许可证

MIT

支持

如有关于此 MCP 服务的问题,请在 GitHub 上提交 issue。

如需 DirectStay API 支持,请直接联系 DirectStay。

评论

支持 Markdown

第一次接触 MCP?

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

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