内容
# MakerPerks MCP-AQL 适配器
MakerPerks上的原生[MCP-AQL](https://github.com/MCPAQL/spec)服务器 — 浏览友好、代理友好的构建者福利目录（免费积分、折扣和面向初创公司、学生、开源维护者、独立开发者和非营利组织的程序）。
它通过**一个**语义工具（`mcp_aql_read`, **约120个代币**）向AI代理公开**整个**目录（200+个程序），而不是一堆离散的MCP工具 — 操作通过自省在运行时发现。这样比传统的“一查询一个工具”服务器减少了约95%的工具注册代币。
## 连接
- **托管（零安装）：** 将 **`https://makerperks.mcpaql.com`** 添加为远程MCP连接器（claude.ai, Claude Code, Cursor, …）。OAuth会自动注册。
- **本地（stdio）：** `npm install && npm run build`，然后将您的MCP客户端指向 `node dist/index.js`。
然后调用 `mcp_aql_read` 并传入 `{ "operation": "introspect" }` 以发现操作：`list_programs`, `get_program`, `search_programs`.
## 工作原理
- MakerPerks发布的`perks.json`上的原生MCP-AQL **读取**接口 — 与MakerPerks解耦（无分叉；更新在刷新时流动）。
- **stdio + 流式HTTP**传输在一个传输无关的核心上。
- 托管在 **Cloudflare Workers**（基于Web标准的流式HTTP）上，由 **OAuth 2.1 + 动态客户端注册** 提供支持，以便OAuth强制客户端连接。端点是 **公开且只读**的。
## 状态
- **上线：** 读取适配器 + 双重传输 + Cloudflare托管 + OAuth — 已完成并存档（`openspec/specs/`）。
- **下一步 — 阶段1：** 一个应用程序管道，用于在用户控制的自主权开关下驱动实际的福利注册。跟踪为GitHub问题（史诗 [#22](https://github.com/MCPAQL/makerperks-adapter/issues/22))。
## 文档
- [`CLAUDE.md`](CLAUDE.md) — 项目配置和约定
- [`docs/ROADMAP.md`](docs/ROADMAP.md) — 分阶段计划
- [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — 系统模型和MCP-AQL基元
- [`openspec/specs/`](openspec/specs/) — 规范基线（功能）
## 许可证
代码和模式：AGPL-3.0（商业层级可用，如MCP-AQL组织的其余部分）。文档：CC BY 4.0。
