Rename MCP server identifier from state-hub to dev-hub

Introduce canonical MCP_SERVER_NAME constants, shared registration helpers,
and a migrate_mcp_config.py script for ~/.claude.json upgrades. Registration,
patch, and custodian CLI checks accept both dev-hub and legacy state-hub during
transition. API root metadata and session-protocol template reflect the new name.
This commit is contained in:
2026-06-22 20:46:14 +02:00
parent 18a5e2d6f0
commit 398f458374
11 changed files with 198 additions and 23 deletions

View File

@@ -1,6 +1,6 @@
#!/usr/bin/env python3
"""
Patch ~/.claude.json to add the cwd field to the state-hub MCP entry.
Patch ~/.claude.json to add the cwd field to the dev-hub MCP entry.
claude mcp add-json silently drops the cwd field. Run this script after
any claude mcp add-json call to restore it.
@@ -11,22 +11,35 @@ import json
import os
from pathlib import Path
from mcp_server.constants import LEGACY_MCP_SERVER_NAME, MCP_SERVER_NAME
from scripts.mcp_registration import load_claude_json, resolve_mcp_server_name
CLAUDE_JSON = Path.home() / ".claude.json"
STATE_HUB_DIR = Path(__file__).resolve().parent.parent # state-hub/
STATE_HUB_DIR = Path(__file__).resolve().parent.parent
def main() -> None:
if not CLAUDE_JSON.exists():
config = load_claude_json(CLAUDE_JSON)
if config is None:
print(f"ERROR: {CLAUDE_JSON} not found. Run 'claude mcp add-json' first.")
raise SystemExit(1)
config = json.loads(CLAUDE_JSON.read_text())
servers = config.setdefault("mcpServers", {})
if "state-hub" not in servers:
print("ERROR: 'state-hub' not found in ~/.claude.json. Run 'claude mcp add-json' first.")
server_name = resolve_mcp_server_name(config)
if server_name is None:
print(
f"ERROR: neither '{MCP_SERVER_NAME}' nor '{LEGACY_MCP_SERVER_NAME}' "
f"found in ~/.claude.json. Run 'claude mcp add-json' first."
)
raise SystemExit(1)
entry = servers["state-hub"]
if server_name == LEGACY_MCP_SERVER_NAME:
print(
f"NOTE: patching legacy '{LEGACY_MCP_SERVER_NAME}' entry. "
"Run scripts/migrate_mcp_config.py to rename to dev-hub."
)
entry = servers[server_name]
cwd_str = str(STATE_HUB_DIR)
if entry.get("cwd") == cwd_str:
@@ -35,8 +48,8 @@ def main() -> None:
entry["cwd"] = cwd_str
CLAUDE_JSON.write_text(json.dumps(config, indent=2) + "\n")
print(f"Patched: ~/.claude.json state-hub.cwd = {cwd_str}")
print(f"Patched: ~/.claude.json {server_name}.cwd = {cwd_str}")
if __name__ == "__main__":
main()
main()