VikingDB MCP server

Name: VikingDB MCP server
Author: KashiwaByte

本地服务

github.com/KashiwaByte数据库662 周前更新

代码仓库

关于 VikingDB MCP server

VikingDB MCP server 将 MCP 客户端连接到字节跳动的向量数据库 VikingDB，提供集合和索引信息查询、信息写入及搜索工具。

主要功能

01查看 VikingDB 集合信息
02查看 VikingDB 索引信息
03写入信息
04搜索已存信息

适用场景

01查看集合详情
02检查索引
03向 VikingDB 写入信息
04在 VikingDB 中搜索信息

MCP 相关

向 MCP 客户端提供 VikingDB 集合与索引信息查询、写入及搜索工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "vikingdb": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

VikingDB MCP 服务

用于 VikingDB 存储和搜索的 MCP 服务

什么是 VikingDB

VikingDB 是由 ByteDance 开发的高性能向量数据库。

按照以下文档即可轻松使用： https://www.volcengine.com/docs/84313/1254444

工具

该服务实现了以下工具：

vikingdb-colleciton-intro：介绍 VikingDB 的集合
vikingdb-index-intro：介绍 VikingDB 的索引
vikingdb-upsert-information：将信息写入 VikingDB，以供后续使用
vikingdb-search-information：在 VikingDB 中搜索信息

配置

vikingdb_host：VikingDB 服务使用的主机。
vikingdb_region：VikingDB 服务使用的区域。
vikingdb_ak：VikingDB 服务使用的访问密钥。
vikingdb_sk：VikingDB 服务使用的秘密密钥。
collection_name：要使用的集合名称。
index_name：要使用的索引名称。

快速入门

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 VikingDB MCP 服务：

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

Claude Desktop

MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：%APPDATA%/Claude/claude_desktop_config.json

开发/未发布服务配置

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

已发布服务配置

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

开发

构建和发布

准备分发软件包：

同步依赖项并更新锁定文件：

uv sync

构建软件包分发文件：

uv build

这将在 dist/ 目录中创建源代码分发包和 wheel 分发包。

发布到 PyPI：

uv publish

注意：需要通过环境变量或命令标志设置 PyPI 凭据：

令牌：--token 或 UV_PUBLISH_TOKEN
或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务通过 stdio 运行，调试可能颇具挑战。为获得最佳调试体验，我们强烈建议使用 MCP Inspector。

你可以通过 npm 使用以下命令启动 MCP Inspector：

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

启动后，Inspector 会显示一个 URL，你可以在浏览器中访问该 URL 开始调试。

支持 Markdown

登录后评论