VikingDB MCP

Name: VikingDB MCP
Author: 火山引擎

火山引擎OfficialChina

Get started Repository

Interact with the Volcengine VikingDB vector database in natural language.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add vikingdb --env VIKING_DB_COLLECTION_NAME='<VIKING_DB_COLLECTION_NAME>' --env VIKING_DB_INDEX_NAME='<VIKING_DB_INDEX_NAME>' --env VIKING_DB_REGION='<VIKING_DB_REGION>' --env VOLCENGINE_ACCESS_KEY='<VOLCENGINE_ACCESS_KEY>' --env VOLCENGINE_SECRET_KEY='<VOLCENGINE_SECRET_KEY>' -- uvx --from 'git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb' mcp-server-vikingdb

~/.codex/config.toml

[mcp_servers.vikingdb]
command = "uvx"
args = ["--from", "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb", "mcp-server-vikingdb"]
env = { VIKING_DB_COLLECTION_NAME = "<VIKING_DB_COLLECTION_NAME>", VIKING_DB_INDEX_NAME = "<VIKING_DB_INDEX_NAME>", VIKING_DB_REGION = "<VIKING_DB_REGION>", VOLCENGINE_ACCESS_KEY = "<VOLCENGINE_ACCESS_KEY>", VOLCENGINE_SECRET_KEY = "<VOLCENGINE_SECRET_KEY>" }

# codex mcp add vikingdb --env VIKING_DB_COLLECTION_NAME='<VIKING_DB_COLLECTION_NAME>' --env VIKING_DB_INDEX_NAME='<VIKING_DB_INDEX_NAME>' --env VIKING_DB_REGION='<VIKING_DB_REGION>' --env VOLCENGINE_ACCESS_KEY='<VOLCENGINE_ACCESS_KEY>' --env VOLCENGINE_SECRET_KEY='<VOLCENGINE_SECRET_KEY>' -- uvx --from 'git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb' mcp-server-vikingdb

~/.cursor/mcp.json

{
  "mcpServers": {
    "vikingdb": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb",
        "mcp-server-vikingdb"
      ],
      "env": {
        "VIKING_DB_COLLECTION_NAME": "<VIKING_DB_COLLECTION_NAME>",
        "VIKING_DB_INDEX_NAME": "<VIKING_DB_INDEX_NAME>",
        "VIKING_DB_REGION": "<VIKING_DB_REGION>",
        "VOLCENGINE_ACCESS_KEY": "<VOLCENGINE_ACCESS_KEY>",
        "VOLCENGINE_SECRET_KEY": "<VOLCENGINE_SECRET_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "vikingdb": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb",
        "mcp-server-vikingdb"
      ],
      "env": {
        "VIKING_DB_COLLECTION_NAME": "<VIKING_DB_COLLECTION_NAME>",
        "VIKING_DB_INDEX_NAME": "<VIKING_DB_INDEX_NAME>",
        "VIKING_DB_REGION": "<VIKING_DB_REGION>",
        "VOLCENGINE_ACCESS_KEY": "<VOLCENGINE_ACCESS_KEY>",
        "VOLCENGINE_SECRET_KEY": "<VOLCENGINE_SECRET_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "vikingdb": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb",
        "mcp-server-vikingdb"
      ],
      "env": {
        "VIKING_DB_COLLECTION_NAME": "<VIKING_DB_COLLECTION_NAME>",
        "VIKING_DB_INDEX_NAME": "<VIKING_DB_INDEX_NAME>",
        "VIKING_DB_REGION": "<VIKING_DB_REGION>",
        "VOLCENGINE_ACCESS_KEY": "<VOLCENGINE_ACCESS_KEY>",
        "VOLCENGINE_SECRET_KEY": "<VOLCENGINE_SECRET_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "vikingdb": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb",
        "mcp-server-vikingdb"
      ],
      "env": {
        "VIKING_DB_COLLECTION_NAME": "<VIKING_DB_COLLECTION_NAME>",
        "VIKING_DB_INDEX_NAME": "<VIKING_DB_INDEX_NAME>",
        "VIKING_DB_REGION": "<VIKING_DB_REGION>",
        "VOLCENGINE_ACCESS_KEY": "<VOLCENGINE_ACCESS_KEY>",
        "VOLCENGINE_SECRET_KEY": "<VOLCENGINE_SECRET_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "vikingdb": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vikingdb",
        "mcp-server-vikingdb"
      ],
      "env": {
        "VIKING_DB_COLLECTION_NAME": "<VIKING_DB_COLLECTION_NAME>",
        "VIKING_DB_INDEX_NAME": "<VIKING_DB_INDEX_NAME>",
        "VIKING_DB_REGION": "<VIKING_DB_REGION>",
        "VOLCENGINE_ACCESS_KEY": "<VOLCENGINE_ACCESS_KEY>",
        "VOLCENGINE_SECRET_KEY": "<VOLCENGINE_SECRET_KEY>"
      }
    }
  }
}

Environment variables

VIKING_DB_COLLECTION_NAME
VIKING_DB_INDEX_NAME
VIKING_DB_REGION
VOLCENGINE_ACCESS_KEY
VOLCENGINE_SECRET_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related