Vikingdb

🚀 VikingDB MCPサーバー

VikingDBの保存と検索を行うためのMCPサーバーです。

📚 VikingDBとは

VikingDBは、ByteDanceによって開発された高性能ベクトルデータベースです。

以下のドキュメントを参照することで、簡単に使用することができます。 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