Cronometer MCP server

Cronometer MCP server

从 Claude.ai 和 Claude Code 读写你的 Cronometer 食物日记。它连接到 mobile.cronometer.com，这是 Cronometer Android 应用所使用的同一 API，并在前面加上 OAuth 2.1 登录，这样你就可以把它作为自定义连接器添加到 Claude.ai。Claude Code 可以直接使用普通令牌。你不需要 Gold 订阅，也不像 CSV 导出那样每天有十次导出限制。

为什么不用其他方案

• Terra API 会将你的 Cronometer 数据发送到一个 webhook，但它只能读取，而且你的食物日志会经过他人的服务器

• gocronometer 及类似的导出工具只能读取，并且会受到速率限制

• 抓取 Cronometer 网站的工具可以写入，但它们依赖的代码每次 Cronometer 发布更新时都会变化，而且它们需要 Gold

Related MCP server: cronometer-api-mcp

工具

读取

写入

自定义食物

add_custom_food 接受一个从营养素名称到数量的字典，因此你可以在一次调用中提供从一种营养素到整个目录的任何内容：

{
  "name": "Vaasan Ruispalat",
  "serving_name": "1 slice",
  "serving_grams": 33,
  "nutrients": {
    "energy": 79, "protein": 3.1, "carbs": 12.5, "fiber": 3.4,
    "fat": 0.8, "saturated": 0.2, "salt_g": 0.36,
    "iron": 0.9, "magnesium": 26, "b1_thiamine": 0.09, "folate": 11
  }
}

这些数量对应一整份，每种都使用该营养素自己的单位。调用 list_nutrients 获取可接受的名称，这些名称来自你账户自己的目录，而不是这里内置的表。

你留空的营养素在 Cronometer 中会保持空白。传递 0 则表示该食物不含该营养素，应用会将这两种情况区别对待，所以只传递你确实知道的内容。无法识别的名称会报错，而不是被悄悄丢弃，因为一种悄悄丢失营养素的饮食看起来仍然完整。

食物标签有而目录没有的两个便利：energy_kj 会转换为卡路里，salt_g 会转换为钠。只传其中一个，不要两个都传。

它是如何整合的

Claude.ai / Claude Code
        |  HTTPS
   Cloudflare Tunnel, or any proxy that gives you HTTPS
        |
   nginx  127.0.0.1:8431
        |
   auth-server.js  :8432    handles the login and the tokens
        |
   cronometer-mcp  :8430    the server itself, local only
        |
   mobile.cronometer.com

服务器本身没有自己的登录，并且它只监听本机。因此，任何到达它的请求都已经通过了登录。该登录接受 OAuth 令牌（Claude.ai 会为你设置）或固定令牌（对 Claude Code 更快）。

安装

git clone https://github.com/rollecode/cronometer-mcp.git
cd cronometer-mcp
./install.sh

安装程序会配置 Python 和 Node，询问你的 Cronometer 登录信息和连接器登录页面的密码，生成一个令牌，并写入服务文件和 nginx 站点，其中已填入你自己的主机名和用户名。

你需要 Node 18 或更高版本、Python 3.12 或更高版本，以及 uv。

将服务器部署到公网由你自己完成，因为这是不同设置差异最大的地方，在这里猜错会让你的食物日记暴露在公共互联网上。将隧道或代理指向 127.0.0.1:8431。使用 Cloudflare Tunnel 时：

ingress:
  - hostname: cronometer-mcp.example.com
    service: http://localhost:8431

必须是 HTTPS。OAuth 无法通过纯 HTTP 工作。

手动自托管

如果你不希望运行安装程序，而是想了解每一步操作，这里就是全部过程。最终状态是你自己机器上运行的两个服务，可通过 HTTPS 访问。

1. 获取代码及其依赖

git clone https://github.com/rollecode/cronometer-mcp.git
cd cronometer-mcp
npm install --omit=dev
uv venv && uv pip install -e .

2. 存储你的 Cronometer 登录信息

./set-credentials.sh

它会提示你输入电子邮件、密码和时区，并将它们写入 ~/.config/cronometer-mcp/env，权限为 0600。密码永远不会回显，也不会进入你的 shell 历史记录。如果你愿意，也可以手动操作：

mkdir -p ~/.config/cronometer-mcp && chmod 700 ~/.config/cronometer-mcp
cat > ~/.config/cronometer-mcp/env <<'EOF'
CRONOMETER_USERNAME=you@example.com
CRONOMETER_PASSWORD=your-password
CRONOMETER_ACCOUNT_TZ=Europe/Helsinki
EOF
chmod 600 ~/.config/cronometer-mcp/env

在继续之前先检查它是否正常工作。下面这条命令会登录并打印你的日记：

set -a && . ~/.config/cronometer-mcp/env && set +a
.venv/bin/python -c "from cronometer_mcp import CronometerClient; c=CronometerClient(); print(c.get_diary()['summary'])"

3. 设置连接器密码和令牌

密码是你在 Claude.ai 中添加连接器时在登录页面输入的内容。只会存储其 scrypt 哈希值。

CONFIG_DIR=~/.config/cronometer-mcp node set-password.js 'your-password-here'

令牌是 Claude Code 使用的快捷方式，它会发送一个请求头并完全跳过浏览器。

openssl rand -hex 32 > ~/.config/cronometer-mcp/token
chmod 600 ~/.config/cronometer-mcp/token

4. 安装这两个服务

systemd/ 包含两个 unit 文件。将 YOUR_USER 替换为你的用户名，将 cronometer-mcp.example.com 替换为你的主机名，然后：

mkdir -p ~/.cache/cronometer-mcp
sudo cp systemd/cronometer-mcp.service systemd/cronometer-mcp-auth.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now cronometer-mcp cronometer-mcp-auth
systemctl status cronometer-mcp cronometer-mcp-auth

cronometer-mcp 是运行在 :8430 的服务器本身，只有它所在的机器可以访问。cronometer-mcp-auth 是 :8432 上的登录层，它是唯一与 :8430 通信的组件。

有一个值得指出的陷阱，因为其症状令人困惑：不要向 cronometer-mcp.service 添加 IPAddressDeny=any。对于只读取本地文件的服务器来说，这是一条合理的加固配置，但这个服务器必须访问 mobile.cronometer.com，而设置后每次工具调用都会挂起直到超时，同时 systemd 仍报告服务处于活动状态。这样做也不会带来任何好处，因为服务器本身已经拒绝在本机之外监听。

5. 在前面放置 nginx

sudo cp nginx/cronometer-mcp.conf /etc/nginx/sites-enabled/cronometer-mcp
sudo nginx -t && sudo systemctl reload nginx

它监听 127.0.0.1:8431，并将所有请求传递给登录层。较长的读取超时时间和 proxy_buffering off 很重要：MCP 会保持连接打开并边生成边发送，而缓冲会导致它停滞。

6. 为它提供一个 HTTPS 地址

Cloudflare Tunnel 可以避免开放路由器端口。任何 HTTPS 反向代理也同样有效。

ingress:
  - hostname: cronometer-mcp.example.com
    service: http://localhost:8431

cloudflared tunnel route dns YOUR_TUNNEL cronometer-mcp.example.com
sudo systemctl restart cloudflared

7. 从外部检查

curl https://cronometer-mcp.example.com/.well-known/oauth-authorization-server
curl -o /dev/null -w '%{http_code}\n' -X POST https://cronometer-mcp.example.com/mcp

第一条命令返回登录详细信息。第二条命令必须返回 401：任何其他结果都意味着登录层被绕过，你的日记已暴露。

然后按照 连接 中的说明连接客户端。

更新

git pull
uv pip install -e . && npm install --omit=dev
sudo systemctl restart cronometer-mcp cronometer-mcp-auth

添加或重命名工具后，在 Claude.ai 中点击连接器上的“重新连接”。这会刷新你已打开的对话中的工具列表，而且你的登录状态会保留，因为令牌存储在磁盘上的 oauth.db 中而不是内存中。

当出现问题时

journalctl -u cronometer-mcp -n 50 --no-pager
journalctl -u cronometer-mcp-auth -n 50 --no-pager

连接

Claude.ai。 前往设置、连接器、添加自定义连接器，然后输入 https://your-host/mcp。将客户端 ID 和密钥留空。使用安装程序设置的密码登录。只需操作一次，即可覆盖 Web、桌面和移动端，因为连接器属于你的账户而非某个设备。

Claude Code（通过浏览器）：

claude mcp add --transport http cronometer https://your-host/mcp --scope user

然后运行 /mcp 登录。

Claude Code（使用令牌，无需浏览器）：

claude mcp add --transport http cronometer https://your-host/mcp \
  --header "Authorization: Bearer $(cat ~/.config/cronometer-mcp/token)" \
  --scope user

完全不使用服务器

如果 Claude 运行在同一台机器上，可以完全跳过 Web 服务器和登录，让它直接启动 MCP：

claude mcp add cronometer -- /path/to/cronometer-mcp/.venv/bin/cronometer-mcp

它从 ~/.config/cronometer-mcp/env 或 .env 文件读取你的登录信息。

设置

所有机密信息都存放在 ~/.config/cronometer-mcp/ 中，只有你可以读取：env 保存你的 Cronometer 登录信息，password-hash 保存连接器登录页的密码，token 保存固定令牌，oauth.db 保存登录服务器已签发的应用和令牌。令牌经过混淆存储，因此即使数据库副本被盗，也不会有人得到可用的密钥。

你的 Cronometer 会话保存在 ~/.cache/cronometer-mcp/session.json 中，因此重启服务器不会反复登录，也不会触发 Cronometer 的限制。

如果你使用两步验证

无人值守运行的服务器无法输入验证码，因此它需要验证码背后的密钥：

uv pip install -e '.[totp]'

然后将 CRONOMETER_TOTP_SECRET 设置为你的身份验证器应用中的密钥。如果没有它，开启了两步验证的账户将无法登录，并会明确告诉你这一点。

代码开发

uv venv && uv pip install -e . && uv pip install pytest ruff
.venv/bin/python -m pytest tests -q
.venv/bin/python -m ruff check src/ tests/

致谢

Cronometer 客户端最初是 rwestergren/cronometer-api-mcp 的副本。登录层来自 rollecode/obsidian-remote-mcp。