Compare commits

...

3 Commits

Author SHA1 Message Date
Michal
1180bbdc1d templates/dav: baked stdio image instead of npx
Some checks failed
CI/CD / typecheck (pull_request) Successful in 1m19s
CI/CD / lint (pull_request) Successful in 2m44s
CI/CD / test (pull_request) Successful in 1m25s
CI/CD / build (pull_request) Successful in 2m46s
CI/CD / smoke (pull_request) Failing after 3m48s
CI/CD / publish (pull_request) Has been skipped
dav-mcp declares tsdav/tsdav-utils as GitHub-URL deps — npx on the
git-less node-runner dies with 'spawn git ENOENT' (observed: dav-michal
CrashLoopBackOff on first deploy). Upstream's ghcr image PID-1s the HTTP
server, so mysources.co.uk/michal/dav-mcp bakes the install and execs
src/server-stdio.js.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-10-01 23:47:12 +01:00
Michal
709068ce68 templates/jmap: drafts3 image + JMAP_REBASE_SESSION_URLS
Some checks failed
CI/CD / lint (pull_request) Successful in 1m14s
CI/CD / test (pull_request) Successful in 1m28s
CI/CD / typecheck (pull_request) Successful in 2m53s
CI/CD / smoke (pull_request) Failing after 2m5s
CI/CD / build (pull_request) Successful in 4m43s
CI/CD / publish (pull_request) Has been skipped
Stalwart's session advertises publicUrl-absolute endpoints; over the
ClusterIP those hairpin through Envoy and 403. Verified in-cluster:
apiUrl came back as https://smtp.ad.itaz.eu/jmap/.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-30 01:42:05 +01:00
Michal
c1f0117b80 templates: jmap, dav, karakeep, ttrss for personal-service projects
Some checks failed
CI/CD / typecheck (pull_request) Successful in 1m20s
CI/CD / lint (pull_request) Successful in 2m38s
CI/CD / test (pull_request) Successful in 1m28s
CI/CD / build (pull_request) Successful in 2m26s
CI/CD / smoke (pull_request) Failing after 3m16s
CI/CD / publish (pull_request) Has been skipped
jmap and ttrss are custom images (mysources.co.uk/michal/{jmap-mcp,ttrss-mcp});
dav-mcp and @karakeep/mcp run on the node runner. Health checks are real
backend calls. Applied live 2026-09-30; these seeds keep the next mcpd
image rebuild from reverting them.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-30 01:35:43 +01:00
4 changed files with 121 additions and 0 deletions

26
templates/dav.yaml Normal file
View File

@@ -0,0 +1,26 @@
name: dav
version: "1.0.0"
description: CalDAV/CardDAV/VTODO (Stalwart or any RFC 4791/6352 server) — calendars, events, tasks, contacts
# NOT packageName: dav-mcp declares tsdav/tsdav-utils as GitHub-URL deps, so
# `npx -y dav-mcp` dies with `spawn git ENOENT` on the git-less node-runner,
# and the upstream ghcr image starts the HTTP server as PID 1. This image
# bakes the install and execs the stdio entrypoint (NODE_OPTIONS baked in).
dockerImage: "mysources.co.uk/michal/dav-mcp:4.0.1-stdio1"
transport: STDIO
repositoryUrl: https://mysources.co.uk/michal/dav-mcp-image
healthCheck:
# A real CalDAV PROPFIND: a pass proves server URL and credentials.
tool: list_calendars
arguments: {}
intervalSeconds: 60
timeoutSeconds: 10
env:
- name: CALDAV_SERVER_URL
description: DAV base URL (e.g. http://stalwart.stalwart.svc.cluster.local:8080)
required: true
- name: CALDAV_USERNAME
description: DAV username
required: true
- name: CALDAV_PASSWORD
description: DAV password (use an app password)
required: true

45
templates/jmap.yaml Normal file
View File

@@ -0,0 +1,45 @@
name: jmap
version: "1.0.0"
description: JMAP email (Stalwart) — search/read/organize + drafts; send and delete gated off by env
dockerImage: "mysources.co.uk/michal/jmap-mcp:0.6.5-drafts3"
transport: STDIO
repositoryUrl: https://mysources.co.uk/michal/jmap-mcp
# No command: the image's entrypoint IS the MCP server (deno run), mcpd
# attaches to PID 1 stdin/stdout. Fork of wyattjoh/jmap-mcp adding
# create_draft/create_draft_reply, JMAP_DISABLE_* gating, and Basic auth
# (jmap-jam upstream only speaks Bearer).
healthCheck:
# A real Mailbox/get: a pass proves session URL, auth, and account
# resolution, not just process liveness.
tool: get_mailboxes
arguments: {}
intervalSeconds: 60
timeoutSeconds: 10
env:
- name: JMAP_SESSION_URL
description: JMAP session URL (e.g. http://stalwart.stalwart.svc.cluster.local:8080/.well-known/jmap)
required: true
- name: JMAP_BEARER_TOKEN
description: Bearer token. Provide either this OR JMAP_USERNAME + JMAP_PASSWORD.
required: false
- name: JMAP_USERNAME
description: Username for HTTP Basic auth (e.g. with a Stalwart app password)
required: false
- name: JMAP_PASSWORD
description: Password/app password for HTTP Basic auth
required: false
- name: JMAP_ACCOUNT_ID
description: Account ID (auto-detected when empty)
required: false
- name: JMAP_DISABLE_SUBMISSION
description: "true = do not register send_email/reply_to_email (drafts only)"
required: false
defaultValue: "true"
- name: JMAP_DISABLE_DELETE
description: "true = do not register delete_emails (move to Trash still works)"
required: false
defaultValue: "true"
- name: JMAP_REBASE_SESSION_URLS
description: "true = rewrite the session's apiUrl/downloadUrl/uploadUrl/eventSourceUrl onto the session URL's origin. Required over a ClusterIP: Stalwart advertises its publicUrl and the hairpinned call 403s at Envoy."
required: false
defaultValue: "true"

24
templates/karakeep.yaml Normal file
View File

@@ -0,0 +1,24 @@
name: karakeep
version: "1.0.0"
description: Karakeep bookmarks — search, read, create, lists, tags, highlights
packageName: "@karakeep/mcp"
runtime: node
transport: STDIO
repositoryUrl: https://github.com/karakeep-app/karakeep
healthCheck:
# A real API call (lists all lists): a pass proves address and API key.
tool: get-lists
arguments: {}
intervalSeconds: 60
timeoutSeconds: 10
env:
- name: KARAKEEP_API_ADDR
description: Karakeep base URL (e.g. http://karakeep-web.karakeep.svc.cluster.local:3000)
required: true
- name: KARAKEEP_API_KEY
description: API key created in the Karakeep UI (Settings → API Keys)
required: true
- name: NODE_OPTIONS
description: V8 heap cap; Node sizes its heap off host RAM, not the cgroup limit
required: false
defaultValue: "--max-old-space-size=384"

26
templates/ttrss.yaml Normal file
View File

@@ -0,0 +1,26 @@
name: ttrss
version: "1.0.0"
description: Tiny Tiny RSS — feeds, headlines, article content, read/star state, subscribe
dockerImage: "mysources.co.uk/michal/ttrss-mcp:1.0.0"
transport: STDIO
repositoryUrl: https://mysources.co.uk/michal/ttrss-mcp
# No command: the image's entrypoint IS the MCP server. Custom server; the
# public tt-rss MCPs only take a pre-made session id and die when it expires.
# This one logs in with user/password and re-logs-in on NOT_LOGGED_IN.
healthCheck:
# A real getCategories call: a pass proves URL, login, and that the
# user's "Enable API access" preference is on.
tool: list_categories
arguments: {}
intervalSeconds: 60
timeoutSeconds: 10
env:
- name: TTRSS_URL
description: Full API endpoint (e.g. http://ttrss.ttrss.svc.cluster.local/api/)
required: true
- name: TTRSS_USER
description: tt-rss user with "Enable API access" set in preferences
required: true
- name: TTRSS_PASSWORD
description: That user's password
required: true