1
MCP Agent Bridge
Hermes Agent edited this page 2026-07-07 14:41:47 +02:00

MCP Agent Infrastructure

All agents are now accessible via MCP (Model Context Protocol) through a unified bridge system.


Bridge Architecture

Hermes Agent (Contabo)
  ├── odysseus-bridge (localhost:7100) — 14 tools
  │   ├── odysseus_health/version/runtime/memory
  │   ├── openclaw_list_models/openclaw_chat
  │   ├── pi_status/pi_health
  │   └── openhands_status/openhands_list_mcp_tools
  ├── openhands (localhost:3002 → Mac Mini:3000 via SSH tunnel) — 5 tools
  │   ├── create_pr (GitHub)
  │   ├── create_mr (GitLab)
  │   ├── create_bitbucket_pr
  │   ├── create_bitbucket_data_center_pr
  │   └── create_azure_devops_pr
  └── Direct MCP Servers (8 total)
      ├── openspace | playwright | gstack
      ├── superpower | uiux-tester | herdr
      ├── odysseus-bridge | openhands

Agent Details

🧠 Odysseus (Mac Mini)

  • Status: Running
  • Port: 7000 (API), 7860 (Web UI)
  • Tools: Memory management, sessions, runtime info, health
  • Backend: Python FastAPI on Mac Mini M1

🤖 Pi Agent (Mac Mini)

  • Status: Running v0.74.2
  • Port: 4747
  • Workspace: FalahMobile
  • Completed Tasks: 15
  • Tools: Status check, health check

🔮 OpenClaw (opencode.ai)

  • Status: Running
  • Models: 20 available, default: deepseek-v4-flash
  • Tools: List models, chat completions

🖐️ OpenHands (Mac Mini)

  • Status: Running (Python venv, not Docker)
  • Port: 3000 (MCP endpoint: /mcp/mcp)
  • Tools: 5 PR/MR creation tools
  • Transport: SSE MCP via SSH tunnel (localhost:3002)

Other Agents (Gitea bot users)

Agent Gitea User Role
Claude Code claude-code Coding assistant
OpenCode MBA opencode-macbookair MacBook Air coding
Pi MBA pi-macbookair MacBook Air AI agent
Hermes MBA hermes-macbookair MacBook Air operations
Hermes Contabo hermes-contabo Contabo operations

How to Use

After a Hermes session reset (/reset), all MCP tools are available directly to the agent. No special commands needed — just call the tool by name.

MCP Server Management

# Add an SSE MCP server
hermes mcp add <name> --url <url>

# List all MCP servers
hermes mcp list

# Test connection
hermes mcp test <name>

# Start a new session to load tools
/reset

Gitea API

# Base URL: http://13.140.161.244:3080
# Auth: Basic (wmj:Abedib@99)
# API: /api/v1/repos/{owner}/{repo}/issues

Infrastructure Hosts

Host Role IP
Contabo Main compute, Docker Swarm, Hermes 13.140.161.244
Mac Mini M1 AI agents (Odysseus, Pi, OpenHands) 100.72.2.115
Synology DS3617xs Docker Swarm manager, NAS 100.126.73.29
MacBook Air Residential IP for cPanel access 100.76.3.26
RoketServer cPanel WordPress hosting 64.20.37.43

Ticket Management — July 2026

Status Count Details
Closed 15 Stale tests, completed items, duplicate/docs
🟢 Active ~60 Assigned to agents across 3 repos
🆕 Created 3 Social media content epic

Key Active Tickets

# Title Agent
#130 [EPIC] Social Media Content openclaw + odysseus
#131 Social Media Research openclaw
#132 Strategy & 90-Day Content odysseus
#104 Fix ody.falahos.my 503 hermes-contabo

Last updated: 2026-07-07 | Session: Full Team Onboarding Complete