Hermes: StarPunk MCP server over OAuth

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
PhilandClaude Opus 5.5 committed 2026-11-12 11:10:09 -07:00
1 parent 0f7ed50ed9
commit 19681ecf40
2 files changed
+18 -1

No files matched your search

+15
View File
@@ -121,6 +121,7 @@ hermes_settings:
mcp_servers.karakeep: "{{ hermes_mcp_karakeep }}" mcp_servers.karakeep: "{{ hermes_mcp_karakeep }}"
mcp_servers.kagi: "{{ hermes_mcp_kagi }}" 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 # 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 # the Mac itself); secrets come from ~/.hermes/.env (hermes_env_secrets) and
@@ -171,6 +172,20 @@ hermes_mcp_kagi:
resources: false resources: false
prompts: 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. # Secrets written to ~/.hermes/.env (single-quoted), from the vault.
hermes_env_secrets: hermes_env_secrets:
KARAKEEP_API_KEY: "{{ vault_cogitator02.karakeep_api_key }}" KARAKEEP_API_KEY: "{{ vault_cogitator02.karakeep_api_key }}"
+3 -1
View File
@@ -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` throwaway Podman container. Secrets they need are in `hermes_env_secrets`
(from the vault) and written to `~/.hermes/.env`. Today: Karakeep, with (from the vault) and written to `~/.hermes/.env`. Today: Karakeep, with
only search/read/create/tag tools registered, and Kagi's hosted server for 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 - **Podman VM** (tag `podman`): a launchd job (`local.podman-machine`) that
starts the VM running Hermes's sandbox at login, and `podman_machine_memory` 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. for its size. A resize stops the VM and starts it again through that job.