Skip to main content
Glama
KashiwaByte

VikingDB

by KashiwaByte

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 中搜索信息

Related MCP server: mmnt-mcp-server

配置

  • 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

克劳德桌面

在 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
  1. 构建软件包分发版:

uv build

这将在dist/目录中创建源和轮子分布。

  1. 发布到 PyPI:

uv publish

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

  • 令牌: --tokenUV_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

启动后,检查器将显示一个 URL,您可以在浏览器中访问该 URL 以开始调试。

Related MCP Connectors

Related MCP Servers