Skip to content
MCP server

Houyidb MCP

MCP server exposing HouyiDB vector search, collection status, and opt-in writes.

Runs locallyStatus and history
Install
Runs
Locally
Version
0.1.0
Listing updated
5 days ago

About Houyidb MCP

Houyidb MCP is an MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add houyidb-mcp --env HOUYI_AUTH_TOKEN='<HOUYI_AUTH_TOKEN>' -- npx -y houyidb-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "houyidb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "houyidb-mcp"
      ],
      "env": {
        "HOUYI_AUTH_TOKEN": "<HOUYI_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "houyidb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "houyidb-mcp"
      ],
      "env": {
        "HOUYI_AUTH_TOKEN": "<HOUYI_AUTH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "houyidb-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "houyidb-mcp"
      ],
      "env": {
        "HOUYI_AUTH_TOKEN": "<HOUYI_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "houyidb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "houyidb-mcp"
      ],
      "env": {
        "HOUYI_AUTH_TOKEN": "<HOUYI_AUTH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "houyidb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "houyidb-mcp"
      ],
      "env": {
        "HOUYI_AUTH_TOKEN": "<HOUYI_AUTH_TOKEN>"
      }
    }
  }
}

Configuration

  • HOUYIDB_URLHouyiDB HTTP base URL.
  • HOUYI_AUTH_TOKENOptional Bearer token sent to HouyiDB.
  • HOUYIDB_MCP_READ_ONLY1 disables upsert/delete; 0 enables writes.
  • HOUYIDB_MCP_COLLECTIONSComma-separated collection allowlist; empty allows all.

Houyidb MCP FAQ

How do I add Houyidb MCP to Claude Code?

Run this command in your terminal: claude mcp add houyidb-mcp --env HOUYI_AUTH_TOKEN='<HOUYI_AUTH_TOKEN>' -- npx -y houyidb-mcp