hypha-mcp

A stdio Model Context Protocol server.

Install

Claude Code

claude mcp add hypha -- npx -y hypha-mcp

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "hypha": {
      "command": "npx",
      "args": ["-y", "hypha-mcp"]
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "hypha": {
      "command": "npx",
      "args": ["-y", "hypha-mcp"]
    }
  }
}

Codex CLI

Edit ~/.codex/config.toml:

[mcp_servers.hypha]
command = "npx"
args = ["-y", "hypha-mcp"]

Other MCP-compliant clients

Stdio server. Connection: command: "npx", args: ["-y", "hypha-mcp"].

First message

After the server connects, paste this as your first message:

Use the list_topics and walk_substrate tools to contextualize yourself on who I want you to be.

Then work normally.

Configuration

Set MYCELIUM_SUBSTRATE_PATH to override the bundled JSON data source (comma-separated for multi-file):

{
  "mcpServers": {
    "hypha": {
      "command": "npx",
      "args": ["-y", "hypha-mcp"],
      "env": {
        "MYCELIUM_SUBSTRATE_PATH": "/absolute/path/to/file.json"
      }
    }
  }
}

License

MIT.