JinDaGe - vikingdb-mcp-server MCP Details

article

README

🚀 VikingDB MCP 服务器

为 VikingDB 存储和搜索实现的 MCP 服务器，可通过下方徽章查看服务器相关信息。

VikingDB 是一款高性能向量数据库，此 MCP 服务器为其存储和搜索功能提供支持，能让你更便捷地使用 VikingDB 进行数据操作。

🚀 快速开始

📦 安装指南

通过 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",
        "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",
          "你的索引名称"
        ]
      }
    }
  }

✨ 主要特性

什么是 VikingDB

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

工具

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

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 | 使用的索引名称 |

📚 详细文档

开发

构建和发布

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

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

uv sync

构建发行版：

uv build

这将在 dist/ 目录中创建源代码和轮分布。 3. 发布到 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 开始调试。

vikingdb-mcp-server