VikingDB MCP サーバー

鍛冶屋のバッジ vikingdb の保存と検索のための MCP サーバー

VikingDBとは

VikingDB は、ByteDance が開発した高性能ベクターデータベースです。

以下のドキュメントに従って簡単に使用できます: https://www.volcengine.com/docs/84313/1254444

ツール

サーバーは次のツールを実装します。

vikingdb-collection-intro: vikingdbのコレクションを紹介します
vikingdb-index-intro: vikingdbのインデックスを紹介します
vikingdb-upsert-information: 後で使用するために vikingdb に情報をアップサートします
vikingdb-search-information: VikingDB内の情報を検索します

Related MCP server: DARPEngine

構成

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

クロードデスクトップ

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"
    ]
   }
  }
}

発達

建築と出版

配布用のパッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

uv sync

パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

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

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。