Vikingdb MCP Server

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

🔧 技術細節

配置

📚 詳細文檔

開發

構建和發佈

要準備分發包，可按以下步驟操作：

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。

你可以使用 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 開始調試。