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_ak：使用的访问密钥。
• vikingdb_sk：使用的密钥。
• 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"
      ]
    }
  }
}

开发

构建与发布

要准备分发包：

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

uv sync

2. 构建和发布：

uv build && uv publish

调试建议

我们推荐使用MCP Inspector工具。下面是使用命令示例：

# 查看日志
uv log mcp-server-vikingdb

# 进入调试界面
uv debug mcp-server-vikingdb

完成翻译后，我会检查是否有遗漏或不通顺的地方，并进行必要的润色，以确保译文流畅、专业。