Vikingdb MCP Server

🚀 VikingDB MCP サーバー

VikingDB のストレージと検索を実現する MCP サーバーです。

🚀 クイックスタート

インストール

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 によって開発された高性能なベクトルデータベースです。 以下のドキュメントを参照することで、簡単に使用することができます。 https://www.volcengine.com/docs/84313/1254444

提供ツール

このサーバーは以下のツールを実装しています。

• 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 にアクセスしてデバッグを開始できます。