mcpField
P
polardbx-mcp

polardbx-mcp

ローカル
github.com/aliyunデータベース418 週間前に更新
リポジトリ

polardbx-mcp について

polardbx-mcpは、AIエージェントがAlibaba Cloud PolarDB-Xデータベースに接続するためのMCPサーバーです。SQL実行や状態確認などのツールに加え、テーブルスキーマをリソースとして提供します。

主な機能

  1. 01PolarDB-XのSQLクエリ実行
  2. 02データベース状態の確認
  3. 03PolarDB-XのSQLコマンド表示
  4. 04テーブルスキーマのリソース提供
  5. 05列名とデータ型の提示

活用シーン

  1. 01エージェント経由でPolarDB-Xを照会
  2. 02PolarDB-Xデータベースの状態確認
  3. 03テーブルの列とデータ型を取得

MCP 対応

MCPサーバーは、PolarDB-Xのクエリ、状態確認、コマンド表示ツールと、列名やデータ型を含むテーブルスキーマのリソースをクライアントに提供します。

#database#aliyun#alibaba#polardb#polardb-x

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "alibabacloud-polardbx": {
      "command": "npx",
      "args": [
        "-y",
        "polardbx-mcp"
      ],
      "env": {
        "POLARDB_X_HOST": "<POLARDB_X_HOST>",
        "POLARDB_X_PORT": "<POLARDB_X_PORT>",
        "POLARDB_X_USER": "<POLARDB_X_USER>",
        "POLARDB_X_PASSWORD": "<POLARDB_X_PASSWORD>",
        "POLARDB_X_DATABASE": "<POLARDB_X_DATABASE>"
      }
    }
  }
}
起動コマンドnpx -y polardbx-mcp
設定が必要な環境変数
POLARDB_X_HOST
POLARDB_X_PORT
POLARDB_X_USER
POLARDB_X_PASSWORDシークレット
POLARDB_X_DATABASE

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmpolardbx-mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

polardbx-mcp

AI エージェントが Alibaba Cloud の PolarDB-X データベースとやり取りできるよう、ツールとリソースを提供する Model Context Protocol（MCP）サーバーです。

インストール

オプション 1：npm からインストール
# Install globally
npm install -g polardbx-mcp

# Or install in current project only
npm install polardbx-mcp
オプション 2：ソースからビルド

  1. このリポジトリをクローンします。

  2. 依存関係をインストールしてビルドします。

npm install
npm run build
  1. 環境変数ファイル .env で PolarDB-X への接続を設定します。
POLARDB_X_HOST=your_database_host
POLARDB_X_PORT=your_database_port
POLARDB_X_USER=your_database_user
POLARDB_X_PASSWORD=your_database_password
POLARDB_X_DATABASE=your_database_name
  1. サーバーを起動します。
npm start

MCP クライアントの設定

npm からインストールした場合の Cline 設定例：

{
  "mcpServers": {
    "polardbx-mcp": {
      "command": "npx",
      "args": [
        "polardbx-mcp"
      ],
      "env": {
        "POLARDB_X_HOST": "your_database_host",
        "POLARDB_X_PORT": "your_database_port",
        "POLARDB_X_USER": "your_database_user",
        "POLARDB_X_PASSWORD": "your_database_password",
        "POLARDB_X_DATABASE": "your_database_name"
      },
    }
  }
}

ソースからビルドした場合の Cline 設定例：

{
  "mcpServers": {
    "polardbx-mcp": {
      "command": "node",
      "args": [
        "path_to_mcp/polardbx-mcp/build/index.js"
      ],
      "env": {
        "POLARDB_X_HOST": "your_database_host",
        "POLARDB_X_PORT": "your_database_port",
        "POLARDB_X_USER": "your_database_user",
        "POLARDB_X_PASSWORD": "your_database_password",
        "POLARDB_X_DATABASE": "your_database_name"
      },
    }
  }
}

MCP サーバーのコンポーネント

ツール
  • query：PolarDB-X で SQL クエリを実行します
  • inspect database status：PolarDB-X のステータスを確認します
  • show all commands：PolarDB-X のすべてのコマンド SQL を表示します
リソース

サーバーは、データベース内の各テーブルのスキーマ情報を提供します。

  • テーブルスキーマ（polardbx://<database_name>/<table_name>）
    • 各テーブルの JSON スキーマ情報
    • カラム名とデータ型を含みます

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。