hybridmind: Skill for Claude Code

HybridMind MCP Server Setup

HybridMind exposes a plug-n-play MCP server at mcp_server/main.py. Once connected, any MCP client gets four memory tools: remember, recall, relate, forget.

Prerequisites

1. HybridMind server must be running at http://localhost:8000 (or another URL you choose):

   cd /path/to/hybridmind
   uvicorn main:app --host 0.0.0.0 --port 8000
   

2. Install the MCP SDK in the HybridMind venv:

   pip install "mcp[cli]"
   

   (Already in requirements.txt — just run pip install -r requirements.txt if starting fresh.)

---

Connecting to Claude Code

Add to ~/.claude/mcp.json (create if it doesn't exist):

{
  "mcpServers": {
    "hybridmind": {
      "command": "python",
      "args": ["/absolute/path/to/hybridmind/mcp_server/main.py"],
      "env": {
        "HYBRIDMIND_API_URL": "http://localhost:8000"
      }
    }
  }
}

Windows path example:

"args": ["D:\\hybridmind\\mcp_server\\main.py"]

Then restart Claude Code. You'll see hybridmind in the MCP servers panel.

---

Connecting to Cursor

In .cursor/mcp.json (workspace) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "hybridmind": {
      "command": "python",
      "args": ["/absolute/path/to/hybridmind/mcp_server/main.py"],
      "env": {
        "HYBRIDMIND_API_URL": "http://localhost:8000"
      }
    }
  }
}

---

Connecting to Windsurf

In ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hybridmind": {
      "command": "python",
      "args": ["/absolute/path/to/hybridmind/mcp_server/main.py"],
      "env": {
        "HYBRIDMIND_API_URL": "http://localhost:8000"
      }
    }
  }
}

---

Connecting to any other MCP client

The MCP server uses stdio transport. Start it with:

python /path/to/hybridmind/mcp_server/main.py

Use mcp dev to inspect the server tools locally:

mcp dev /path/to/hybridmind/mcp_server/main.py