内容
# mcp-a2a-ap2-im-hungry 🍔💳
MCP server，使用 **A2A protocol** (食物配送) + **AP2 protocol** (授权支付).
## Demo
## Flow
## Quick Start
```bash
git clone https://github.com/tas1337/mcp-a2a-ap2-im-hungry.git
cd mcp-a2a-ap2-im-hungry
npm start
```
**Services:**
- MCP Server: `http://localhost:8000/mcp`
- Registry: `http://localhost:8004`
- DoorDash/UberEats/Grubhub: `8001-8003` (A2A)
- Stripe: `http://localhost:8005` (AP2)
## What's Different from mcp-a2a-im-hungry?
| mcp-a2a-im-hungry | This project |
|-------------------|--------------|
| A2A only | A2A + **AP2** |
| No payments | Stripe payments |
| — | **Mandates** (signed authorization) |
## What is AP2?
Problem: AI agents spending money. Who approved it?
**AP2 = Payments with Mandates** — cryptographically signed proof of user intent.
```
MANDATE = { userId, maxAmount, expires, signature }
```
**Flow (matches real-world AP2):**
1. User asks for cheeseburger 🍔
2. Your agent searches restaurants via A2A (discovers DoorDash/UberEats/Grubhub agents)
3. Your agent gets menus and delivery estimates
4. Your agent decides which restaurant (cheapest/fastest)
5. **User authorizes payment** → User's authorization service creates mandate (signed with user's private key)
6. **Your agent requests authorization** → Receives mandate from user
7. **Your agent sends payment request WITH mandate to Stripe agent** (via A2A)
8. **Stripe agent VERIFIES mandate** (signature valid? not expired? amount ok?)
9. If valid → Stripe processes payment ✅
10. **Your agent places order with food delivery agent** (DoorDash/UberEats/Grubhub via A2A)
11. 🍔 Burger incoming!
**Key Point:** The agent NEVER creates mandates. User authorization creates them. Agent only uses them.
## Project Structure
```
src/
├── a2a-client.ts # Calls ANY agent (food or Stripe)
├── tools.ts # Food tools
├── ap2-tools.ts # Payment tools (requests user authorization)
├── user-authorization.ts # User creates mandates (real-world: wallet/auth service)
mock-agents/
├── food-delivery/ # DoorDash, UberEats, Grubhub
├── payments/ # Stripe (verifies mandates!)
└── registry/ # Agent discovery
```
## 工具列表
| Tool | Description |
|------|-------------|
| `search_restaurants` | Search food (A2A) |
| `get_menu` | Get menu (A2A) |
| `place_order` | Order food (A2A) |
| `process_payment` | Pay via Stripe (AP2 + Mandate) |
| `process_refund` | Refund via Stripe (AP2 + Mandate) |
## Connect to Cursor
```json
{
"mcpServers": {
"mcp-a2a-ap2-im-hungry": {
"url": "http://localhost:8000/mcp"
}
}
}
```
## Resources
- [A2A Protocol (Google)](https://developers.googleblog.com/a2a-a-new-era-of-agent-interoperability/)
- [MCP Specification](https://modelcontextprotocol.io)
- [AP2 Protocol (Google)](https://cloud.google.com/blog/products/ai-machine-learning/announcing-agents-to-payments-ap2-protocol)
