Kashiwabyte Vikingdb MCP Server

🚀 VikingDB MCP サーバー

VikingDB のストレージと検索のために実装された MCP サーバー

VikingDB MCP サーバーは、VikingDB という高性能ベクトルデータベースのための MCP サーバーです。これにより、VikingDB でのデータの格納と検索が可能になります。

📚 什么是 VikingDB（VikingDB とは）

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

以下のドキュメントを参照することで、簡単に使用することができます： https://www.volcengine.com/docs/84313/1254444

🛠️ 工具（ツール）

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

• vikingdb-collection-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 @smithery/cli install mcp-server-vikingdb --client claude

Claude Desktop

• MacOS：~/Library/Application\ 支持/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",
          "你的索引名称"
        ]
     }
    }
  } 

💻 開発

🔨 構築と公開

配布パッケージを準備するには：

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 の使用を強くおすすめします。

以下のコマンドで MCP Inspector を起動できます：

npx @modelcontextprotocol/inspector uv --directory mcp_server_vikingdb 所在的目录 run mcp-server-vikingdb --vikingdb-host 你的主机 --vikingdb-region 你的区域 --vikingdb-ak 你的访问密钥 --vikingdb-sk 你的秘密密钥 --collection-name 你的集合名称 --index-name 你的索引名称

起動後、Inspector は URL を表示します。この URL をブラウザで開くと、デバッグを開始できます。