MCP Skill – Server Operations
Use this when you need to stand up, restart, or debug MCP servers that live inside this workspace.
Tooling
node/npmmcporterCLI (npm i -g mcporter)curl,jqfor quick HTTP checks- Source lives under
bridge/(Julia relay) or futurebridge-*/folders
Typical Workflow
- Install deps (per server folder):
cd bridge npm install - Start the server:
Logs appear withnpm start[bridge]prefixes. - Register with mcporter:
mcporter config add julia-bridge http://127.0.0.1:3001 --transport http - Health check:
mcporter call julia-bridge.bridge_health - Expose tools: ensure each MCP method is documented via a skill (
skills/julia-bridge/*.yml).
Adding a New MCP Server
mkdir bridge-<name>andnpm init -y.- Add
server.jsusing@modelcontextprotocol/sdk(StreamableHTTP or SSE transport). - Define tools with Zod schemas (
registerTool). Always return structured content when specifying anoutputSchema. - Provide HTTP helper endpoints (e.g.,
/health,/queues) if needed. - Document operations in a dedicated skill folder (
skills/<name>/). - Update
agents/to include the new skills.
Debugging Checklist
| Symptom | Action |
|---|---|
HTTP 404 from mcporter |
Server not routing /mcp correctly – verify Streamable HTTP handler. |
Output validation error |
Ensure tool response includes structuredContent matching the outputSchema. |
| Hang on start | Run node server.js directly to catch stack traces. |
| Multiple servers needed | Run each in its own terminal or use tmux (skills/tmux). |
Heartbeats & Queues (Bridge Example)
/heartbeat/<peer>to update status./queues/<target>to inspect or debug stuck messages./inboundfor Julia → OpenClaw posts.
Logging & Memory
- Capture major incidents in
memory/YYYY-MM-DD.md. - If a new pattern emerges, add a heuristic in
HEURISTICS.md(e.g., “restart mcporter config when endpoint changes”).
Related Skills
skills/julia-bridge– specific procedures for the Julia relayskills/agents– wiring MCP tools into agent manifestsskills/agents-system– fleet-wide maintenance