Alibaba Cloud Lindorm

🚀 Lindorm MCP サーバー

このリポジトリは、多モード対応の NoSQL データベースである Lindorm 用の MCP サーバーを作成する方法のサンプルです。

🚀 クイックスタート

Lindorm 上の設定

この MCP サーバーを利用するには、以下の手順に従ってください。

1. Alibaba Cloud で Lindorm の幅広いテーブルエンジン、検索エンジン、ベクトルエンジン、AI エンジンを購入します。
2. 公式ガイド に従って、テキスト埋め込みモデルをデプロイします。
3. デプロイした埋め込みモデルを使用してインデックス（知識ベース）を作成し、データをインポートします。

環境構築

1. このリポジトリをクローンし、プロジェクトディレクトリに移動します。
2. 環境ファイルを作成します。

cp .env.example .env

3. .env ファイルを必要に応じて編集します。

• LINDORM_INSTANCE_ID: あなたの Lindorm インスタンス ID
• USING_VPC_NETWORK: VPC ネットワーク上で実行する場合は true、そうでない場合は false
• USERNAME: あなたの Lindorm アカウントのユーザー名
• PASSWORD: あなたの Lindorm アカウントのパスワード
• TEXT_EMBEDDING_MODEL: デプロイされたテキスト埋め込みモデルの名前
• TABLE_DATABASE: SQL 操作を実行するデータベース

注意: この設定では、すべてのエンジンが同じユーザー名とパスワードを共有することを前提としています。

MCP サーバーの実行

uv をインストールする必要があります。 MCP サーバーを直接起動します。

cd /path/to/alibabacloud-lindorm-mcp-server/

uv pip install .

uv run python -m src.lindorm_mcp_server.server

Visual Studio Code

1. Cline 拡張機能をインストールします。
2. /path/to/alibabacloud-lindorm-mcp-server/ の下に .env ファイルを作成します。
3. .vscode/mcp.json から MCP 設定を cline_mcp_settings.json にコピーし、必要に応じてパスと変数を置き換えます。
4. Cline 拡張機能を使用して MCP サーバーを起動します。

✨ 主な機能

コンポーネント

• LindormVectorSearchClient: 検索およびベクトルエンジン上で全文検索とベクトル検索を実行します。
• LindormWideTableClient: Lindorm の幅広いテーブルに対して SQL 操作を実行します。

利用可能なツール

• lindorm_retrieve_from_index: 既存のインデックス（または知識ベース）から全文検索とベクトル検索を使用し、集約結果を返します。
  • パラメータ:
    • index_name: インデックス名、つまり知識ベース名
    • query: 知識ベース内で検索するクエリ内容
    • content_field: コンテンツテキストを格納するフィールド。lindorm_get_index_mappings ツールを使用してインデックス構造から取得できます。
    • vector_field: ベクトルインデックスを格納するフィールド。lindorm_get_index_mappings ツールを使用してインデックス構造から取得できます。
    • top_k: 返す結果の数
• lindorm_get_index_fields: インデックス（または知識ベース）のフィールド情報を取得し、特にベクトルとコンテンツを格納するフィールドを取得します。
  • パラメータ:
    • index_name: インデックス名、つまり知識ベース名
• lindorm_list_all_index: すべてのインデックス（または知識ベース）をリストします。
• lindorm_execute_sql: Lindorm データベース上で SQL クエリを実行します。
  • パラメータ:
    • query: select で始まる実行する SQL クエリ
• lindorm_show_tables: Lindorm データベース内のすべてのテーブルを取得します。
• lindorm_describe_table: Lindorm データベース内のテーブルのスキーマ情報を取得します。
  • パラメータ:
    • table_name: テーブル名