Coffee Company MCP Server
Coffee Company B2B 开放平台 MCP Server —— 让 AI Agent 通过 MCP 协议调用Coffee Company现有 HTTP 开放平台能力。
所有 MCP Tool 严格 1:1 映射
openapi.coffeecompany.com现有 HTTP 接口，不新增业务逻辑。 鉴权由 Kong 网关处理，MCP 层只做协议转换 + 语义化格式化。
Quick Start
# 安装依赖 (需要 uv + Python 3.13)
uv sync
# 运行完整 Demo（9 步流程演示）
uv run coffee demo
# 交互式模式
uv run coffee interactive
Architecture
B2B Agent (蔚来/千问/飞猪)
│ MCP Protocol (SSE / Streamable HTTP)
▼
┌──────────── Kong ────────────┐
│ HMAC Auth ✓ ACL ✓ 限流 ✓ │ ← 复用现有 B2B 客户凭证
│ │
│ /sse, /mcp → MCP Adapter │ ← 新增 2 条路由
│ /coupon/* → 现有后端 │ ← 不动
└──────────────┬───────────────┘
▼
MCP Adapter (本项目)
├── MCP 协议处理
├── Tool 权限过滤
├── 参数映射
└── 语义化转换
│ 内网直连
▼
openapi-platform 后端 (不动)
Phase 1 Tools（10 个只读，当前可用）
| MCP Tool | HTTP API | 功能 |
|---|---|---|
member_query | POST /crmadapter/account/query | 查询会员信息 |
member_tier | POST /crmadapter/account/memberTier | 会员等级详情 |
member_benefits | POST /crmadapter/customers/getBenefits | 8 项权益状态 |
member_benefit_list | POST /crmadapter/asset/coupon/getBenefitList | 券列表 |
coupon_query | POST /coupon/query | 订单券码查询 |
coupon_detail | POST /coupon/detail | 券码详情 |
equity_query | POST /equity/query | 权益发放查询 |
equity_detail | POST /equity/detail | 权益详情 |
assets_list | POST /assets/list | 客户全部资产 |
cashier_pay_query | POST /cashier/payQuery | 支付状态查询 |
CLI 命令
uv run coffee member 138****1234 # 查会员（手机号）
uv run coffee member CC_M_100001 # 查会员（会员ID）
uv run coffee tier CC_M_100001 # 等级详情
uv run coffee benefits CC_M_100001 # 权益状态
uv run coffee assets CC_M_100001 # 全部资产
uv run coffee coupon CC20260301A001 # 券码详情
uv run coffee equity EQ_2026030100001 # 权益详情
uv run coffee pay PAY_TOKEN_001 # 支付状态
接入 Claude Code / Cursor
{
"mcpServers": {
"coffee-company": {
"command": "uv",
"args": ["--directory", "/path/to/coffee-company-mcp", "run", "coffee-company-mcp"]
}
}
}
B2B 场景示例
蔚来车机 Agent：
车主: "帮我查一下我的Coffee Company会员等级和可用优惠券"
Agent 调用链:
member_query(mobile="138****1234") → 确认金星会员
member_tier(member_id="CC_M_100001") → 142 颗星，距钻星差 358 颗
assets_list(member_id="CC_M_100001") → 3 张可用券
Docs
- Architecture — 完整 API 映射表 + 分期开放策略
- Deploy Decision — Kong 架构下的部署方案分析
License
MIT