mcphub

MCP FastMCP 1 deps

MCPHub control-plane metadata MCP server

Repo MCP server (hand-maintained)

Composed compose-mcp-wave-1 from mcp/mcphub/. Do not run wagents docs generate on this file (HAND-MAINTAINED sentinel).

Usage

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcphub": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "mcp/mcphub",
        "python",
        "server.py"
      ]
    }
  }
}

Package

Field	Value
Name	mcp-mcphub
Version	0.1.0
Python	>=3.13

Dependencies

fastmcp>=2

FastMCP Config

{
  "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json",
  "source": {
    "path": "server.py",
    "entrypoint": "mcp"
  },
  "environment": {
    "type": "uv"
  }
}

Server Source

mcp/mcphub/server.py

"""MCPHub control-plane metadata MCP server."""

from __future__ import annotations

from pathlib import Path

from fastmcp import FastMCP

mcp = FastMCP("MCPHub")

ROOT = Path(__file__).resolve().parents[2]
SETTINGS_PATH = ROOT / "mcp" / "mcphub" / "mcp_settings.json"


@mcp.tool(
    annotations={
        "readOnlyHint": True,
        "destructiveHint": False,
        "idempotentHint": True,
        "openWorldHint": False,
    },
)
def mcphub_status() -> dict[str, str | bool]:
    """Return local MCPHub scaffold status and config location.

    Use this tool when checking whether the repo-owned MCPHub scaffold is
    present and where its generated settings file lives. It does not start,
    stop, mutate, or validate the running MCPHub process. It returns static
    local paths and endpoint metadata that clients can use for follow-up checks.
    """
    return {
        "name": "mcphub",
        "description": "Local MCP control-plane configuration scaffold.",
        "settings_path": str(SETTINGS_PATH),
        "settings_exists": SETTINGS_PATH.exists(),
        "managed_url": "http://127.0.0.1:46683",
        "mcp_endpoint": "http://127.0.0.1:46683/mcp",
    }

Resources

MCP Overview Browse all MCP documentation in this site.

CLI Reference Scaffold new MCP servers with wagents.

---

View source on GitHub