Kashiwabyte Vikingdb MCP Server

🚀 VikingDB MCP 服務器

VikingDB MCP 服務器為 VikingDB 的存儲和搜索功能提供支持，可有效助力數據的存儲與檢索工作。

🚀 快速開始

什麼是 VikingDB

VikingDB 是由字節跳動開發的一款高性能向量數據庫。您可以按照以下文檔輕鬆使用它：VikingDB 使用文檔

工具

該服務器實現了以下工具：

• vikingdb-collection-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：要使用的索引名稱。

安裝

使用 Smithery 安裝

通過 Smithery 自動安裝 VikingDB MCP 服務器以供 Claude Desktop 使用：

npx @smithery/cli install mcp-server-vikingdb --client claude

Claude Desktop 配置文件路徑

• MacOS：~/Library/Application\ 支持/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",
          "你的索引名稱"
        ]
     }
    }
  } 

🔧 技術細節

開發

構建和發佈

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

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。 您可以通過以下命令啟動 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory mcp_server_vikingdb 所在的目錄 run mcp-server-vikingdb --vikingdb-host 你的主機 --vikingdb-region 你的區域 --vikingdb-ak 你的訪問密鑰 --vikingdb-sk 你的秘密密鑰 --collection-name 你的集合名稱 --index-name 你的索引名稱

啟動後，Inspector 會顯示一個 URL，您可以在瀏覽器中打開該 URL 開始調試。