diff --git a/group_vars/mac/main.yml b/group_vars/mac/main.yml index b8bfbe9..2d61611 100644 --- a/group_vars/mac/main.yml +++ b/group_vars/mac/main.yml @@ -121,6 +121,7 @@ hermes_settings: mcp_servers.karakeep: "{{ hermes_mcp_karakeep }}" mcp_servers.kagi: "{{ hermes_mcp_kagi }}" + mcp_servers.starpunk: "{{ hermes_mcp_starpunk }}" # MCP servers. Each stdio server runs in a throwaway Podman container (not on # the Mac itself); secrets come from ~/.hermes/.env (hermes_env_secrets) and @@ -171,6 +172,20 @@ hermes_mcp_kagi: resources: false prompts: false +# StarPunk (notes on the website), StarPunk's own /mcp endpoint. OAuth, no +# secret in the vault: run `hermes mcp login starpunk` on the Mac once (paste +# the redirect URL back), and again when the 90-day token expires (StarPunk +# issues no refresh tokens). Hermes signs in with its CIMD client document. +# Read tools are marked read-only, so "untrusted" asks only before writes +# (create/update/delete/undelete note, upload media). See StarPunk ADR-075. +hermes_mcp_starpunk: + url: "https://{{ subdomains.starpunk }}/mcp" + auth: oauth + trust: untrusted + tools: + resources: false + prompts: false + # Secrets written to ~/.hermes/.env (single-quoted), from the vault. hermes_env_secrets: KARAKEEP_API_KEY: "{{ vault_cogitator02.karakeep_api_key }}" diff --git a/roles/mac/README.md b/roles/mac/README.md index 3e5aeb6..cf390c6 100644 --- a/roles/mac/README.md +++ b/roles/mac/README.md @@ -54,7 +54,9 @@ Manages cogitator-02, an Apple Silicon Mac on the tailnet (`mac.yml`, 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, and Kagi's hosted server for - web search and page fetching (Hermes's built-in `web` toolset is off). + web search and page fetching (Hermes's built-in `web` toolset is off), and + StarPunk's `/mcp` endpoint for notes (OAuth: `hermes mcp login starpunk` + on the Mac, again every 90 days). - **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.