Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Coffee Company MCP ServerList all my available coffee coupons and member benefits."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 interactiveArchitecture
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 | 功能 |
|
| 查询会员信息 |
|
| 会员等级详情 |
|
| 8 项权益状态 |
|
| 券列表 |
|
| 订单券码查询 |
|
| 券码详情 |
|
| 权益发放查询 |
|
| 权益详情 |
|
| 客户全部资产 |
|
| 支付状态查询 |
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