🚀 VikingDB MCP 服务器

VikingDB MCP 服务器为 VikingDB 的存储和搜索功能提供支持，可有效助力数据的存储与检索工作。

🚀 快速开始

什么是 VikingDB

VikingDB 是由字节跳动开发的一款高性能向量数据库。您可以按照以下文档轻松使用它：VikingDB 使用文档

工具

该服务器实现了以下工具：

• vikingdb-collection-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 自动安装 VikingDB MCP 服务器以供 Claude Desktop 使用：

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

Claude Desktop 配置文件路径

• MacOS：~/Library/Application\ 支持/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", 
        "你的访问密钥",
        "--vikingdb-sk", 
        "你的秘密密钥",
        "--collection-name",
        "你的集合名称",
        "--index-name",
        "你的索引名称"
      ]
    }
  }
}

已发布的服务器配置

{
    "mcpServers": {
      "mcp-server-vikingdb": {
        "command": "uvx",
        "args": [
          "mcp-server-vikingdb",
          "--vikingdb-host", 
          "你的主机",
          "--vikingdb-region", 
          "你的区域",
          "--vikingdb-ak", 
          "你的访问密钥",
          "--vikingdb-sk", 
          "你的秘密密钥",
          "--collection-name",
          "你的集合名称",
          "--index-name",
          "你的索引名称"
        ]
     }
    }
  } 

🔧 技术细节

开发

构建和发布

为了准备分发包，可按以下步骤操作：

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

uv sync

2. 构建分发包：

uv build

这将在 dist/ 目录下创建源代码和轮式发行版。 3. 发布到 PyPI：

uv publish

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

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

调试

由于 MCP 服务器通过 stdio 运行，调试可能会很困难。为了获得最佳的调试体验，我们强烈推荐使用 MCP Inspector。 您可以通过以下命令启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory mcp_server_vikingdb 所在的目录 run mcp-server-vikingdb --vikingdb-host 你的主机 --vikingdb-region 你的区域 --vikingdb-ak 你的访问密钥 --vikingdb-sk 你的秘密密钥 --collection-name 你的集合名称 --index-name 你的索引名称

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