向量数据库服务

VikingDB MCP server是一个高性能的向量数据库服务,提供数据存储和搜索功能,适用于需要高效向量处理的场景。

  • by KashiwaByte
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 KashiwaByte/vikingdb-mcp-server

使用说明

Viking DB MCP服务器

用于vikingdb存储和搜索的mcp服务器

什么是Viking DB

VikingDB是ByteDance开发的高性能矢量数据库。

您可以按照以下说明轻松使用它: https://www.volcengine.com/docs/84313/1254444

工具

服务器实现了以下工具:

  • vikingdb集合介绍:介绍vikingdb的集合

  • vikingdb索引介绍:介绍vikingdb的索引

  • vikingdb追加信息:将信息追加到vikingdb以供以后使用

  • vikingdb搜索信息:在vikingdb中搜索信息

配置

  • vikingdb_host:用于vikingdb服务器的主机。

  • vikingdb_region:用于vikingdb服务器的区域。

  • vikingdb_ak:用于vikingdb服务器的访问密钥。

  • vikingdb_sk:用于vikingdb服务器的密钥。

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

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

快速启动

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的Viking DB 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凭据:

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

调试

由于MCP服务器在stdio上运行,调试可能具有挑战性。为了达到最佳调试效果 经验,我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 npm 使用此命令:

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