使用说明
细致的Espresso MCP服务器
你的精致意式浓缩咖啡机，连接到LLM。从自然语言生成食谱，分析镜头，拨入你的研磨机，并通过克劳德持续记录镜头日记。
不需要Anthropic API密钥。没有云订阅。只有你的机器、LLM和本地IP。
60秒后开始
将此添加到您的Claude Desktop或Claude Code配置中，您就完成了：
克劳德桌面 — ~/Library/Application Support/Claude/claude_desktop_config.json
克劳德代码 — ~/.claude.json
{
"mcpServers": {
"meticulous": {
"command": "npx",
"args": ["-y", "github:erdos2n/meticulous-mcp-server"],
"env": {
"METICULOUS_IP": "192.168.x.x"
}
}
}
}
替换 192.168.x.x 使用您机器的本地IP（在路由器或细致应用程序中找到它）。重启克劳德。就是这样——没有克隆，没有构建，没有需要管理的依赖关系。
想在克劳德手机或Claude.ai上看到这个吗？ 您需要在本地网络上安装Raspberry Pi。请参阅 LLM_SETUP.md 和 PI_SETUP_INSTRUCTIONS.md.
你能做什么
Pull the shot data from my last espresso and tell me what to adjust.
Generate a recipe for a washed Ethiopian, 18g dose, 1:2.5 ratio, slow bloom.
Save my grinder setting — I'm on the DF83 at 10.2 for the Osmotic flow profile.
Read my shot diary and tell me what's been working.
My last three shots were sour. Look at the shot data and suggest a fix.
List all my profiles and load the one I used last week for the natural.
它的作用
- 生成和调整食谱 从简单的语言，验证并加载到机器上
- 分析镜头 --提取传感器数据并给出具体的配方改进建议
- 管理配置文件 --列出、加载、保存、删除、浏览工厂和社区食谱
- 控制机器 --启动、停止、称重、预热、重置
- 履带打磨机设置 跨会话的每个配置文件——永远不要重新解释您的拨号
- 记下拍摄日记 --聊天之间持续存在的品尝笔记和观察结果
研磨机设置和日记以普通文件的形式存储在 ~/.meticulous-mcp/ 在你的机器上。无需数据库，无需设置，只需在任何文本编辑器中打开即可。
所有可用工具
机器控制
| 工具 | 它做什么 |
|---|---|
get_device_info |
固件、串行、型号、软件版本 |
execute_action |
启动/停止/称重/预热/重置/校准 |
get_settings |
读取机器设置 |
update_setting |
更改机器设置 |
get_notifications |
待处理或已确认的机器通知 |
档案
| 工具 | 它做什么 |
|---|---|
list_profiles |
机器上存储的所有配置文件 |
get_all_profiles |
每个配置文件的完整详细信息 |
get_profile |
按UUID排列的单一配置文件 |
get_last_profile |
当前活动配置文件 |
get_default_profiles |
工厂+社区简介 |
load_profile |
加载配方（临时） |
load_profile_by_id |
按UUID加载现有配置文件 |
save_profile |
将配方永久保存到机器中 |
delete_profile |
按UUID删除配置文件 |
validate_recipe |
检查架构+自动修复简单错误 |
射击历史
| 工具 | 它做什么 |
|---|---|
get_shot_history |
最近拍摄的带有元数据的照片 |
search_history |
按名称、日期、顺序、限制进行筛选 |
get_current_shot |
正在进行的射击的实时数据 |
get_last_shot |
最近拍摄的传感器数据 |
get_shot_statistics |
总射击次数，按配置文件细分 |
get_shot_data_for_analysis |
全镜头+剖面图，用于深入分析 |
rate_shot |
将一个镜头标记为喜欢/不喜欢 |
search_historical_profiles |
查找过去的配置文件版本 |
研磨机+日记
| 工具 | 它做什么 |
|---|---|
get_grinder_context |
召回所有配置文件的已保存研磨机设置 |
set_grinder_context |
保存轮廓的当前研磨机设置 |
read_diary |
阅读完整的日记 |
append_diary_entry |
用品酒笔记记录一次拍摄 |
镜头数据冗长
快照工具默认为压缩响应，以保持上下文窗口的可管理性：
| 选项 | 你会得到什么 |
|---|---|
verbosity: "summary" |
仅关键元数据 |
verbosity: "compact" |
元数据+采样跟踪（默认） |
verbosity: "full" |
完整原始有效载荷 |
完整设置选项
看 LLM_SETUP.md 适用于所有安装路径——笔记本电脑、克隆和构建以及Raspberry Pi远程访问。
项目布局
meticulous-mcp-server/
├── src/
│ ├── server.ts # All 25 MCP tools + machine logic
│ ├── index.ts # stdio entry point (laptop / Claude Desktop / Claude Code)
│ └── http.ts # HTTP entry point (Pi / Cloudflare / claude.ai)
├── dist/ # Compiled output
├── LLM_SETUP.md # Setup guide for all install paths
├── PI_SETUP_INSTRUCTIONS.md # Full Pi + Cloudflare Tunnel walkthrough
├── Justfile # Build, run, deploy, test commands
└── pi-setup.sh # Pi dependency installer