VikingDB

You set up an MCP Server to store and search VikingDB data, enabling high‑performance vector querying through a configurable VikingDB backend. This guide walks you through practical usage, installation steps, and key configuration details so you can deploy and operate the VikingDB MCP Server with ease.

How to use

You run the VikingDB MCP Server as a local (stdio) or remote (http) MCP endpoint that your MCP clients connect to. The server exposes tools to introduce VikingDB collections and indexes, upsert documents, and perform searches. To start, configure the VikingDB host, region, access key, and secret key, along with the target collection and index. Your MCP client sends requests to the server to upsert data and run vector searches, enabling fast retrieval from VikingDB.

How to install

Prerequisites you need before starting: Node.js and npm (to run MCP tooling), and the MVP MCP runtime tooling (uv or uvx) to launch the server. You will also prepare VikingDB connection details (host, region, ak, sk) and the VikingDB collection and index names.

Install via Smithery to integrate with Claude Desktop (example workflow):

npx @smithery/cli install mcp-server-vikingdb --client claude

Development and Published server configurations

The VikingDB MCP Server can run in two modes. Use the Development/Unpublished flow for local testing or the Published flow for a ready‑to‑deploy setup. Both configurations specify how to start the server and pass VikingDB connection details.

{
  "mcpServers": {
    "mcp-server-vikingdb": {
      "command": "uv",
      "args": [
        "--directory",
        "dir to mcp-server-vikingdb",
        "run",
        "mcp-server-vikingdb",
        "--vikingdb-host", 
        "your host",
        "--vikingdb-region", 
        "your region",
        "--vikingdb-ak", 
        "your access key",
        "--vikingdb-sk", 
        "your secret key",
        "--collection-name",
        "your collection name",
        "--index-name",
        "your index name"
      ]
    }
  }
}

Published server configuration

{
  "mcpServers": {
    "mcp-server-vikingdb": {
      "command": "uvx",
      "args": [
        "mcp-server-vikingdb",
        "--vikingdb-host", 
        "your host",
        "--vikingdb-region", 
        "your region",
        "--vikingdb-ak", 
        "your access key",
        "--vikingdb-sk", 
        "your secret key",
        "--collection-name",
        "your collection name",
        "--index-name",
        "your index name"
      ]
    }
  }
}

Available tools

vikingdb-colleciton-intro

Introduces the VikingDB collection and its purpose within VikingDB MCP Server.

vikingdb-index-intro

Introduces the VikingDB index and how it relates to query performance and organization.

vikingdb-upsert-information

Upserts information into VikingDB for later retrieval and search.

vikingdb-search-information

Searches VikingDB for information using the configured index and collection.