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 がインスペクタに表示されます。