VikingDB MCP server

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 サーバーに使用するリージョンです。

• 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

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

これにより、ソース配布物とホイール配布物が 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 にブラウザーからアクセスしてデバッグを開始できます。