Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

feat(brain): remote HTTP MCP server on Charlie :8501#138

Open
Mikecranesync wants to merge 2 commits intomainfrom
feat/brain-mcp-http
Open

feat(brain): remote HTTP MCP server on Charlie :8501#138
Mikecranesync wants to merge 2 commits intomainfrom
feat/brain-mcp-http

Conversation

@Mikecranesync
Copy link
Copy Markdown
Owner

Summary

  • brain_server.py: Added env-var-driven MCP_HOST/MCP_PORT/MCP_TRANSPORT config, /health endpoint, streamable-http mode with optional bearer auth via BRAIN_ACCESS_KEY
  • deploy-brain-mcp-mac.sh: One-shot deploy script for Charlie Mac Mini — installs deps, creates launchd plist, loads service on port 8501, disables sleep, prints claude mcp add command
  • Stdio mode unchanged (default) — existing .mcp.json usage unaffected

Why

Every cluster device needs brain tools (brain_search, brain_capture, etc.). Previously required local Python, venv, and repo on each machine. Now: single persistent HTTP server on Charlie, one claude mcp add per device.

claude mcp add --transport http open-brain \
  http://100.82.246.52:8501/mcp

Test plan

  • Deploy script runs clean on Charlie
  • Health check passes: curl -sf http://localhost:8501/health
  • MCP endpoint responds (streamable-http handshake)
  • Register from another device via claude mcp add --transport http
  • Call brain_search("test") from remote Claude Code session
  • Reboot Charlie → service auto-starts

🤖 Generated with Claude Code

CharlieNode and others added 2 commits March 9, 2026 06:59
- brain-feed.yml: continue-on-error, fast timeouts, jq payload, dead letter queue
- ci-watchdog.yml: 30-min health check, severity classification, auto-issue management
- replay-brain-dlq.sh: replay failed payloads once endpoint recovers
- INC-2026-03-09-001: incident report for 14 consecutive failures
- Ops trace documenting the change

Fixes brain-feed blocking all pushes when brain-ingest endpoint is down.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- brain_server.py: env-var-driven host/port/transport (MCP_HOST, MCP_PORT, MCP_TRANSPORT)
- brain_server.py: /health endpoint via custom_route (public, no auth)
- brain_server.py: streamable-http mode with optional bearer auth (BRAIN_ACCESS_KEY)
- deploy-brain-mcp-mac.sh: one-shot deploy for Charlie Mac Mini (port 8501, launchd)
- requirements.txt: add mcp[cli] and httpx

Enables multi-device access: claude mcp add --transport http open-brain http://<tailscale-ip>:8501/mcp
Brain-ingest on :8500 untouched.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant