MCP Directory
Back to MCP Servers

KashiwaByte/vikingdb-mcp-server

Databases

An MCP server for VikingDB store and search.

Python codebaseCloud Service

Installation

Claude Desktop

Installation Command

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

Configuration

{
  "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 Servers 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"\
    ]
   }
  }
}

Instructions

To install VikingDB MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-server-vikingdb): ```bash npx -y @smithery/cli install mcp-server-vikingdb --client claude ``` On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json` On Windows: `%APPDATA%/Claude/claude_desktop_config.json`

README

VikingDB MCP server

Permalink: VikingDB MCP server

smithery badge an mcp server for vikingdb store and search

What is VikingDB

Permalink: What is VikingDB

VikingDB is a high-performance vector database developed by ByteDance.

You can easily use it following the doc bellow: https://www.volcengine.com/docs/84313/1254444

Tools

Permalink: Tools

The server implements the following tools:

  • vikingdb-colleciton-intro: introduce the collection of vikingdb

  • vikingdb-index-intro: introduce the index of vikingdb

  • vikingdb-upsert-information: upsert information to vikingdb for later use

  • vikingdb-search-information: searche for information in the VikingDB

Configuration

Permalink: Configuration

  • vikingdb_host: The host to use for the VikingDB server.

  • vikingdb_region: The region to use for the VikingDB server.

  • vikingdb_ak: The Access Key to use for the VikingDB server.

  • vikingdb_sk: The Secret Key to use for the VikingDB server.

  • collection_name: The name of the collection to use.

  • index_name: The name of the index to use.

Quickstart

Permalink: Quickstart

Install

Permalink: Install

Installing via Smithery

Permalink: Installing via Smithery

To install VikingDB MCP server for Claude Desktop automatically via Smithery:

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

Claude Desktop

Permalink: Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

Development/Unpublished Servers Configuration

{
  "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 Servers 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"\
    ]
   }
  }
}

Development

Permalink: Development

Building and Publishing

Permalink: Building and Publishing

To prepare the package for distribution:

  1. Sync dependencies and update lockfile:
uv sync
  1. Build package distributions:
uv build

This will create source and wheel distributions in the dist/ directory.

  1. Publish to PyPI:
uv publish

Note: You'll need to set PyPI credentials via environment variables or command flags:

  • Token: --token or UV_PUBLISH_TOKEN
  • Or username/password: --username/ UV_PUBLISH_USERNAME and --password/ UV_PUBLISH_PASSWORD

Debugging

Permalink: Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --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

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

About

a mcp server for vikingdb store and search

Resources

Readme

Activity

Stars

2
stars

Watchers

1
watching

Forks

0
forks

Report repository

Releases\ 1

vikingdb-mcp-server-0.1.2
Latest

Dec 7, 2024

Packages\ 0

No packages published

Contributors\ 2

Languages

KashiwaByte/vikingdb-mcp-server - MCP Directory