DoorDash Drive API MCP Server 使用说明

项目简介

本项目 'DoorDash Drive API MCP Server' 是一个 MCP (Model Context Protocol) 服务器的实现，它将 DoorDash Drive API 的各项功能封装成一系列易于 LLM (Large Language Model) 调用的工具 (Tools)。通过此 MCP 服务器，LLM 客户端可以方便地集成 DoorDash 的配送能力，例如创建配送报价、发起配送、查询配送状态，以及管理 DoorDash 平台上的商家和门店信息。

主要功能点

配送管理工具: 提供创建配送报价、接受报价、创建配送订单、查询配送详情、更新配送信息、取消配送等工具，方便 LLM 客户端集成 DoorDash 的配送服务。
商家/门店管理工具: 提供查询商家信息、更新商家信息、列出商家、查询门店信息、更新门店信息、创建门店、列出门店等工具，帮助 LLM 客户端管理 DoorDash 平台上的业务信息。
商品替换推荐工具: 提供获取商品替换建议的工具，增强订单处理的灵活性。
结账审计信号工具: 提供创建结账审计信号的工具，用于订单的审计和监控。
基于标准 MCP 协议: 采用 Model Context Protocol 标准，易于与各种 MCP 客户端集成，实现与 LLM 的无缝对接。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node Package Manager)。
下载仓库代码: 从 GitHub 仓库 https://github.com/JordanDalton/DoorDash-MCP-Server 下载项目代码到本地。
安装依赖并构建项目: 打开命令行终端，进入项目代码根目录，运行以下命令：
```
npm install && npm run build
```
此命令会安装项目依赖，并编译 TypeScript 代码到 'build' 目录。

服务器配置

MCP 服务器需要配置到 MCP 客户端才能使用。根据仓库提供的 'README.md' 和 'showSettings.js'，你需要将以下 JSON 配置信息复制到你的 MCP 客户端中。 请务必将 '<REPLACE>' 替换为你的 DoorDash API Key。

{
  "mcpServers": {
    "doordash": {
      "command": "node",  // 运行 MCP 服务器的命令，这里使用 node
      "args": [         // 启动命令的参数
        "<thePathToYour>/build/index.js" //  指向编译后的 index.js 文件路径，请替换为你的实际路径
      ],
      "env": [         // 环境变量配置
        {
          "DOORDASH_API_KEY": "<REPLACE>" // DoorDash API Key，请替换为你的 API Key
        }
      ]
    }
  }
}

配置参数说明:

'"doordash"': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'"command": "node"': 指定运行服务器的命令为 'node'，假设你的环境中 'node' 命令可用。
'"args": ["<thePathToYour>/build/index.js"]': 'args' 数组包含启动 'node' 命令的参数，这里指向编译生成的 'build/index.js' 文件。 你需要将 '<thePathToYour>' 替换为你的项目 'build/index.js' 文件的绝对路径。 例如，如果你的项目在 '/Users/yourname/DoorDash-MCP-Server'，那么路径可能是 '/Users/yourname/DoorDash-MCP-Server/build/index.js'。
'"env": [{ "DOORDASH_API_KEY": "<REPLACE>" }]': 'env' 数组用于设置环境变量。这里设置了 'DOORDASH_API_KEY' 环境变量，用于存储你的 DoorDash API Key。 请务必将 '<REPLACE>' 替换为你的实际 DoorDash API Key。 这个 API Key 用于服务器向 DoorDash API 发起请求时的身份验证。

基本使用方法

启动 MCP 服务器: 配置完成后，当 MCP 客户端尝试连接 'doordash' 服务器时，客户端会根据你提供的配置启动 'node <thePathToYour>/build/index.js' 命令，从而启动 MCP 服务器。服务器通过标准输入/输出 (stdio) 与 MCP 客户端进行通信。
在 MCP 客户端中使用工具: 启动服务器并成功连接后，你可以在 MCP 客户端中看到 'DoorDashDriveAPI' 服务器提供的所有工具。根据你的需求，可以使用 LLM 自然语言指令或客户端提供的界面来调用这些工具，例如：
- 让 LLM 客户端调用 'create_delivery' 工具来创建一个新的配送订单。
- 让 LLM 客户端调用 'get_store' 工具来查询某个门店的详细信息。
- 工具的具体使用参数和返回结果请参考项目代码 'src/index.ts' 中每个 'server.tool()' 方法的定义。

注意:

API Key 安全: 请妥善保管你的 DoorDash API Key，避免泄露。
路径配置: 请确保 'args' 中 'index.js' 的路径配置正确，否则 MCP 服务器可能无法启动。
环境变量: 'DOORDASH_API_KEY' 环境变量是必须配置的，否则服务器将无法通过身份验证访问 DoorDash API。
DoorDash API 权限: 确保你的 DoorDash API Key 拥有访问 Drive API 和 Developer API 的权限，否则部分工具可能无法正常使用。

关键词