meican-mcp

美餐（Meican）MCP Server。支持查询餐次、餐厅、菜单、订单，以及下单和取消订单。

可用工具

| 工具 | 用途 | |---|---| | meican_whoami | 查询组织信息和取餐地址。 | | meican_list_meal_tabs | 查询某天可用餐次。 | | meican_list_restaurants | 查询某个餐次下可用餐厅。 | | meican_show_menu | 查询某个餐厅在指定餐次下的菜单。 | | meican_list_orders | 查询某天已有订单和未支付项目摘要。 | | meican_show_order | 查询单个订单详情。 | | meican_place_order | 下单。调用前必须向用户确认。 | | meican_cancel_order | 取消订单。调用前必须向用户确认。 |

工具返回一个 MCP text content block，内容是 JSON 字符串：

{ "ok": true, "data": {} }

失败时：

{ "ok": false, "error": { "message": "...", "status": 400, "body": {}, "kind": "MeicanError" } }

token 过期时会自动刷新并保存，无需手动更新环境变量。

快速使用

{
  "mcpServers": {
    "meican": {
      "command": "npx",
      "args": ["-y", "meican-mcp"],
      "env": {
        "MEICAN_CLIENT_ID": "...",
        "MEICAN_CLIENT_SECRET": "...",
        "MEICAN_ACCESS_TOKEN": "...",
        "MEICAN_REFRESH_TOKEN": "...",
        "MEICAN_NAMESPACE": "..."
      }
    }
  }
}

MEICAN_ACCESS_TOKEN 对应美餐的 cookie sat，MEICAN_REFRESH_TOKEN 对应美餐的 cookie srt。

本地配置

推荐将登录信息放在本地配置文件中：

• Linux/macOS：~/.config/meican-mcp/config.json
• Windows：%APPDATA%\meican-mcp\config.json

{
  "clientId": "...",
  "clientSecret": "...",
  "accessToken": "...",
  "refreshToken": "...",
  "namespace": "..."
}

accessToken 对应美餐 cookie sat，refreshToken 对应 cookie srt。token 过期后， server 会自动刷新并更新这个文件。

本地配置优先于环境变量。需要修改配置文件位置时，可设置 MEICAN_CONFIG_FILE。

环境变量

| 变量 | 必填 | 说明 | |---|---:|---| | MEICAN_CLIENT_ID | 否 | 美餐 OAuth client id；也可配置 clientId。两处至少提供一处。 | | MEICAN_CLIENT_SECRET | 否 | 美餐 OAuth client secret；也可配置 clientSecret。两处至少提供一处。 | | MEICAN_ACCESS_TOKEN | 否 | 美餐 sat cookie；也可配置 accessToken 或在调用时传入。 | | MEICAN_REFRESH_TOKEN | 否 | 美餐 srt cookie；也可配置 refreshToken 或在调用时传入。 | | MEICAN_NAMESPACE | 否 | 默认组织/站点 namespace。也可以在工具调用参数里传。 | | MEICAN_API_BASE_URL | 否 | 默认 https://www.meican.com/forward/api。 | | MEICAN_CONFIG_FILE | 否 | 覆盖本地配置文件的完整路径。 |

HTTP 模式相关：

| 变量 | 必填 | 说明 | |---|---:|---| | MCP_API_KEY | 是 | HTTP /mcp 的 Bearer token，随便生成一个，不带 token 的不允许调用。 | | BIND_HOST | 否 | 默认 127.0.0.1。容器内通常用 0.0.0.0。 | | PORT | 否 | 默认 3000。 | | LOG_LEVEL | 否 | 默认 info。可选 debug、info、warn、error。 |

HTTP 模式

npm install
cp .env.example .env
# 编辑 .env
npm run build
npm start

健康检查：

curl http://127.0.0.1:3000/healthz

HTTP MCP 配置示例：

{
  "mcpServers": {
    "meican": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_API_KEY}"
      }
    }
  }
}