Repository navigation
Add HTTP transport for cia hosting - #21
Merged
Merged
Conversation
Adds http_server.py alongside the existing stdio server.py, wrapping FastMCP's http_app() with the same pure-ASGI X-API-Key middleware pattern reed already uses (src/reed/mcp_server.py in the reed repo), plus a Containerfile so the server can run as a Podman Quadlet unit on cia rather than a local stdio process tied to whichever Mac happens to be current. Mirrors the migration already done for reed and redwrench.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
http_server.pyalongside the existing stdioserver.py: wraps FastMCP'shttp_app()with the same pure-ASGI X-API-Key middleware pattern reed already uses, so this server can run as an HTTP MCP service over Tailscale instead of a local stdio process.Dockerfileso it can be built and run as a Podman Quadlet unit oncia, mirroring the reed and redwrench hosting pattern.uvicornas an explicit dependency and a*-httpconsole-script entry point.Part of the decision (23 Sep 2026) to port rainkeeper, google-tasks-mcp, and bos-mcp off the local Mac onto
cia(always-on home server), so MCP hosting no longer depends on which Mac happens to be current.Test plan
http_server.appbuilds cleanly under the repo's own venv.cia, verified reachable viaX-API-Keyover Tailscale.🤖 Generated with Claude Code