agent-hub-mcp: Instructions file for Claude Code

CLAUDE.md - Agent Hub MCP Developer Guide

This file provides guidance to Claude Code (claude.ai/code) when working with the Agent Hub MCP codebase.

Quick Start

1. Install & Build

pnpm install
pnpm run build

2. Configure Claude Code (stdio - Recommended)

Add to your Claude Code settings:

{
  "mcpServers": {
    "agent-hub": {
      "command": "node",
      "args": ["/path/to/agent-hub-mcp/dist/index.js"],
      "env": {
        "AGENT_HUB_DATA_DIR": "/path/to/.agent-hub"
      }
    }
  }
}

For development with tsx:

{
  "mcpServers": {
    "agent-hub": {
      "command": "tsx",
      "args": ["/path/to/agent-hub-mcp/src/index.ts"]
    }
  }
}

3. Test Multi-Agent Collaboration

• Open multiple Claude Code instances in different projects
• Register each agent with mcp__agent-hub__register_agent
• Use messaging and context sharing tools

Common Commands

pnpm test          # Run test suite
pnpm run dev       # Start HTTP server (port 3737)
pnpm run lint      # Check code quality
pnpm run coverage  # Test coverage report

IMPORTANT: Multi-Agent Collaboration System

You are part of a collaborative multi-agent system! The Agent Hub MCP enables communication between multiple Claude Code instances working on different projects.

On Session Start:

1. Register with the hub:

   • Use mcp__agent-hub__register_agent with project-based ID
   • Notify user: "Connected to Agent Hub as [agent-id]"

2. Stay synchronized:

   • Use sync tool periodically to get messages, workload updates, and hub changes in one call
   • Inform user of any pending collaboration work
   • Example: "📬 You have 3 messages from frontend-agent about API changes"

3. Share your work context:

   • When making significant changes, proactively notify other agents about relevant updates
   • Use feature tools to track progress and share context within project boundaries

During Work:

• Be proactive about collaboration: Check for messages when working on interfaces, APIs, or shared components
• Announce major changes: Inform other agents about breaking changes or new features
• Respond to direct questions: Other agents may send questions via messages