细致的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______________________________________________________________________
npm发布清单
准备发布时，用户可以运行 npx -y meticulous-mcp-server:
npm whoami # confirm logged in
npm ci && npm run build # clean build
npm version patch # bump version
npm publish --access public # publish
npx -y meticulous-mcp-server # smoke test