VikingDB

a mcp server for vikingdb store and search

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kashiwabyte-vikingdb-mcp-server": {
      "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"
      ]
    }
  }
}

You can run a VikingDB MCP server to store and search VikingDB data via a lightweight MCP interface. This server connects to VikingDB, enabling you to upsert information, learn about collections and indexes, and perform search operations through MCP clients.

How to use

Connect to the VikingDB MCP server using your MCP client by selecting either a local (stdio) or remote (http) MCP configuration. For stdio configurations, start the MCP server process and pass the required VikingDB connection details and collection/index names. Your MCP client will communicate through the standard input/output streams as if the server were another local program. You can perform the following core actions: introduce VikingDB collections and indexes, upsert information for later use, and search stored information.

How to install

Prerequisites: ensure you have Node.js and npm installed to access command-line tools used for MCP server installation and debugging.

Install VikingDB MCP server for Claude Desktop automatically via Smithery:

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

Additional setup for Claude Desktop

On MacOS, Claude Desktop configuration is located at: ~/Library/Application\ Support/Claude/claude_desktop_config.json. On Windows, it is at: %APPDATA%/Claude/claude_desktop_config.json.

Configuration and runtime options

Two runtime configurations are provided for development and publishing. Use the development configuration to run locally and test the server during development. Use the published configuration to run in a published environment.

{
  "mcpServers": {
    "mcp-server-vikingdb-dev": {
      "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"
      ]
    },
    "mcp-server-vikingdb-publ": {
      "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

Provides an introduction to VikingDB collections, including how to create and manage a collection used by the MCP server.

vikingdb-index-intro

Gives an overview of VikingDB indexes and how they enable efficient search within a collection.

vikingdb-upsert-information

Enables you to upsert information into VikingDB through the MCP server for subsequent queries.

vikingdb-search-information

Lets you perform searches against VikingDB data stored via the MCP server.

Built by

VeilStrat

AI signals for GTM teams