VikingDB MCP 服务器

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

什么是 VikingDB

VikingDB 是字节跳动开发的高性能向量数据库。

您可以按照以下文档轻松使用它： 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 服务器使用的 Access Key。

• vikingdb_sk: VikingDB 服务器使用的 Secret Key。

• collection_name: 要使用的集合的名称。

• index_name: 要使用的索引的名称。

快速开始

安装

通过 Smithery 安装

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

npx @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",
        "mcp-server-vikingdb 的目录",
        "run",
        "mcp-server-vikingdb",
        "--vikingdb-host", 
        "您的主机",
        "--vikingdb-region", 
        "您的区域",
        "--vikingdb-ak", 
        "您的 access key",
        "--vikingdb-sk", 
        "您的 secret key",
        "--collection-name",
        "您的集合名称",
        "--index-name",
        "您的索引名称"
      ]
    }
  }
}

已发布的服务器配置

{
  "mcpServers": {
    "mcp-server-vikingdb": {
      "command": "uvx",
      "args": [
        "mcp-server-vikingdb",
        "--vikingdb-host", 
        "您的主机",
        "--vikingdb-region", 
        "您的区域",
        "--vikingdb-ak", 
        "您的 access key",
        "--vikingdb-sk", 
        "您的 secret key",
        "--collection-name",
        "您的集合名称",
        "--index-name",
        "您的索引名称"
    ]
   }
  }
} 

开发

构建和发布

要准备用于分发的软件包：

1. 同步依赖项并更新 lockfile：

uv sync

2. 构建软件包分发：

uv build

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

3. 发布到 PyPI：

uv publish

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

• Token：--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 以开始调试。