内容
# Aiden 配方生成器（MCP）
一个与您的 Fellow Aiden 咖啡机对话的 MCP 服务器 - 完全使用 Cursor 构建。
**发送您的咖啡豆照片或名称** 给 Claude、Cursor 或任何兼容 MCP 的工具，它将：
- 在互联网上搜索该特定咖啡的冲泡建议
- 在 Aiden 配方社区数据库中搜索类似产地/烘焙度的配方
- 检查您之前的冲泡记录和反馈，以了解哪些是有效的
- 查询您的特定磨豆机的磨豆设置
- 直接为您的 Aiden 生成并推送自定义冲泡配置文件
不再需要在 Fellow 应用程序中手动调整每个变量 - 只需向它展示您的咖啡，让它处理剩下的事情。
<img width="732" height="645" alt="ss-aiden" src="https://github.com/user-attachments/assets/3e304182-d40e-4570-ae2c-406f8a140f56" />
## 起源故事
在捷克布拉格的 Cafe Cursor 活动上，我正在思考如何使用 Cursor 构建项目。到目前为止，我主要使用 Claude Code，因此我希望从头开始一个项目，以便真正测试 Cursor 的功能。
然后，我注意到一件让我立即感到高兴的事情：他们有自己的咖啡豆袋，来自 [Terminal](https://terminal.shop)。
我有点像咖啡爱好者，我一直想尝试他们的咖啡，但由于他们只运往美国，所以在欧洲几乎不可能买到。结果他们与 Cursor 合作，所以我在活动中成功获得了一袋“Cafe Cursor”咖啡豆。瞬间赢得。
然后，显而易见的问题出现了：**如何正确冲泡这杯咖啡？**
袋子背面当然有一个配方，但如果你是咖啡爱好者，你知道真正的乐趣在于调整你自己的配方。温度、倒入、浸泡时间、比例……所有这些细节。
我使用 Fellow Aiden 咖啡机，它允许你通过他们的移动应用程序构建完全自定义的配方。非常强大，但由于你基本上是在手动调整每个变量，所以可能会非常耗时。
所以我想…… **如果我让 Cursor 来决定如何冲泡他们的咖啡呢？**
如果我使用 Cursor 构建一个与我的咖啡机（通过 Cursor）对话的 MCP 服务器，并为这款“Cafe Cursor”咖啡找出最佳配方呢？
因此，我反向工程了 Fellow 移动应用程序发送给机器的 API 请求，将其封装到这个 MCP 服务器中，现在我可以使用 Cursor（或 Claude）为我的咖啡机生成和推送自定义咖啡配方。
**完整的循环：Cafe Cursor 咖啡 → Cursor → MCP（由 Cursor 构建）→ 幸福**
## 功能
- **网络研究** - 为您的特定咖啡搜索冲泡建议
- **社区配方** - 在社区 Aiden 配方数据库中搜索类似咖啡
- **磨豆设置** - 查询您的特定磨豆机的推荐磨豆设置
- **配置文件创建** - 为您的 Aiden 创建并推送自定义冲泡配置文件
- **记忆** - 记录冲泡记录和反馈，以从过去的尝试中学习
- **用户设置** - 记住您的磨豆机等
## 设置
```bash
# 克隆此仓库
git clone https://github.com/bxxf/aiden-recipe-generator.git
# 安装依赖
bun install
# 添加到 Claude Code
claude mcp add aiden bun run /path-to-this-repo/src/index.ts
```
## 工具
| 工具 | 描述 |
|------|-------------|
| `auth.login` | 登录 Fellow 账户 |
| `auth.status` | 检查登录状态 |
| `aiden.listDevices` | 列出已连接的 Aiden 冲泡器 |
| `aiden.listProfiles` | 列出设备上的配置文件 |
| `aiden.createProfile` | 创建新的冲泡配置文件 |
| `aiden.updateProfile` | 更新现有的配置文件 |
| `aiden.deleteProfile` | 删除配置文件 |
| `sheet.search` | 按产地/烘焙/加工方式搜索社区配方 |
| `memory.logBrew` | 记录一次冲泡尝试 |
| `memory.addFeedback` | 添加口感反馈（评分、备注） |
| `memory.findSimilar` | 查找过去冲泡过类似咖啡的记录 |
| `user.getSettings` | 获取保存的偏好设置 |
| `user.updateSettings` | 保存偏好设置（磨豆机、设备等） |
## 工作原理
当您请求冲泡一杯咖啡时：
1. 检查您保存的设置（磨豆机、默认设备）
2. 在社区表格中搜索类似的咖啡
3. 检查您的冲泡历史记录，查找过去的尝试
4. 在互联网上搜索该特定咖啡的推荐
5. 查询您的磨豆机的磨豆设置
6. 根据所有研究创建配置文件
7. 记录冲泡记录，以便未来学习
在您品尝后，给出反馈，它会记住哪些是有效的。
## 限制
**无法远程开始冲泡** - Fellow API 没有提供实际开始冲泡的端点。移动应用程序也有同样的限制 - 您可以创建和管理配置文件，但您必须亲自按下机器上的按钮来开始冲泡。这可能是故意的（安全，确保水/篮子到位等）。
潜在的解决方法：Fellow 支持定时冲泡。如果 API 提供调度管理，您理论上可以调度一个“1 分钟后”的冲泡。目前尚未探索。
## 许可证
MIT
