Mac: Karakeep MCP server for Hermes

Hermes can search and read bookmarks, create them, tag them and add them
to lists from Telegram. Per Karakeep's MCP README and Hermes's MCP docs:
- the official server image (pinned 0.34.1) runs in a throwaway Podman
  container (`podman run -i --rm`), started on first use and stopped
  after 10 idle minutes;
- only search/read/create/tag/add-to-list tools are registered (no update
  or delete); trust: full because Karakeep doesn't mark its search tools
  read-only;
- the API key is in the vault, written to ~/.hermes/.env via the new
  hermes_env_secrets, and passed into the container by name.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
PhilandClaude Opus 5.5 committed 2026-11-11 08:29:54 -07:00
1 parent a0e49f4670
commit cccdca1469
3 files changed
+60

No files matched your search

+5
View File
@@ -32,6 +32,11 @@ Manages cogitator-02, an Apple Silicon Mac on the tailnet (`mac.yml`,
cron on GLM-5.3 Flash, subagents on DeepSeek V4.1 Flash, `/model` aliases.
Keys in `hermes_settings_force` are set with `--force` (Hermes reads
`agent.reasoning_effort` but `config set` refuses it, hermes-agent #140221).
- **MCP servers and secrets** (also tag `hermes-settings`): MCP servers are
`mcp_servers.<name>` entries in `hermes_settings`, each running in a
throwaway Podman container. Secrets they need are in `hermes_env_secrets`
(from the vault) and written to `~/.hermes/.env`. Today: Karakeep, with
only search/read/create/tag tools registered.
- **Podman VM** (tag `podman`): a launchd job (`local.podman-machine`) that
starts the VM running Hermes's sandbox at login, and `podman_machine_memory`
for its size. A resize stops the VM and starts it again through that job.
+13
View File
@@ -1,3 +1,16 @@
# Secrets go in first, so servers and settings that reference them
# (${VAR}) find them when the gateway restarts.
- name: Secrets in Hermes's .env
ansible.builtin.lineinfile:
path: "{{ hermes_env }}"
regexp: "^{{ item.key }}="
line: "{{ item.key }}='{{ item.value }}'"
mode: "0600"
loop: "{{ hermes_env_secrets | default({}) | dict2items }}"
no_log: true
diff: false
notify: [Restart Hermes gateway, Restart Hermes dashboard]
# `hermes config get` prints the value as YAML, so it's compared
# structurally; `hermes config set` takes JSON for lists and booleans.
# Settings are always set explicitly: for a key that isn't in config.yaml,