English Français العربية

io.github.houyidb-community/houyidb-mcp

Official registry Data and databases

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package houyidb-mcp
Claude Code 
claude mcp add houyidb-mcp -e 'HOUYIDB_URL=http://127.0.0.1:17000' -e 'HOUYI_AUTH_TOKEN=<your houyi_auth_token>' -e 'HOUYIDB_MCP_READ_ONLY=1' -e 'HOUYIDB_MCP_COLLECTIONS=<HOUYIDB_MCP_COLLECTIONS>' -- npx -y houyidb-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "houyidb-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "houyidb-mcp@0.1.0"
            ],
            "env": {
                "HOUYIDB_URL": "http://127.0.0.1:17000",
                "HOUYI_AUTH_TOKEN": "<your houyi_auth_token>",
                "HOUYIDB_MCP_READ_ONLY": "1",
                "HOUYIDB_MCP_COLLECTIONS": "<HOUYIDB_MCP_COLLECTIONS>"
            }
        }
    }
}

Environment variables

  • HOUYIDB_URL HouyiDB HTTP base URL.
  • HOUYI_AUTH_TOKEN secret Optional Bearer token sent to HouyiDB.
  • HOUYIDB_MCP_READ_ONLY 1 disables upsert/delete; 0 enables writes.
  • HOUYIDB_MCP_COLLECTIONS Comma-separated collection allowlist; empty allows all.

Frequently asked questions

What is io.github.houyidb-community/houyidb-mcp?

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

How do I install io.github.houyidb-community/houyidb-mcp?

It runs on your machine. In Claude Code: claude mcp add houyidb-mcp -e 'HOUYIDB_URL=http://127.0.0.1:17000' -e 'HOUYI_AUTH_TOKEN=<your houyi_auth_token>' -e 'HOUYIDB_MCP_READ_ONLY=1' -e 'HOUYIDB_MCP_COLLECTIONS=<HOUYIDB_MCP_COLLECTIONS>' -- npx -y houyidb-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.houyidb-community/houyidb-mcp need an API key?

Yes. It expects HOUYI_AUTH_TOKEN, which you set in its configuration.

Who maintains io.github.houyidb-community/houyidb-mcp?

It is published by houyidb-community. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.