Alibaba Cloud Yaochi DB MCP Server

Alibaba Cloud Yaochi DB MCP サーバー

Yaochi Database AI Native MCP Server — Alibaba Cloud のすべてのデータベースを管理する、ひとつの MCP サーバーです。

中文版 README

Yaochi DB MCP サーバーとは？

Model Context Protocol（MCP） を基盤に構築されたデータベースツールサービスです。AI コーディングアシスタント（Cursor、Claude Desktop、Qoder など）から Alibaba Cloud のデータベースを直接操作できます。

主なシナリオ：AI がコードを作成した後、データベースの作成 → テーブルの作成 → 検証のための SQL 実行 → パフォーマンス診断のための Yaochi Database Agent の呼び出しまで、すべて IDE を離れずに自動で行います。

対応データベースエンジン

エンジン	操作
RDS MySQL	インスタンスの作成、SQL の実行、一時アカウントモード
PolarDB MySQL	クラスターの作成、SQL の実行、一時アカウントモード
MongoDB	レプリカセットの作成、MongoDB コマンドの実行
Tair (Redis)	インスタンスの作成、Redis コマンドの実行

Yaochi Database Agent

Alibaba Cloud の公式ドキュメントと専門知識を活用する、組み込みの AI データベースアドバイザーです。

• ナレッジに関する質問への回答 — データベースの使用方法に関する質問に即座に回答し、サポートチケットを削減します
• インテリジェント診断 — OpenAPI 経由でパフォーマンス診断を自動実行し、問題を特定します
• ベストプラクティス — ワークロードに合わせたアーキテクチャの推奨事項と最適化の提案を提供します

複数ターンの会話に対応し、Alibaba Cloud のすべてのデータベースエンジン（RDS、PolarDB、MongoDB、Tair、Lindorm など）をカバーします。

利用可能なツール

ツール	説明
ask_yaochi_agent	Yaochi Database Agent — AI データベースアドバイザー（診断、ベストプラクティス、アーキテクチャ）
create_instance	データベースインスタンスを作成します
list_instances	既存のインスタンスを一覧表示します
execute_instance_sql	インスタンス ID を使用して SQL を実行します（一時アカウントを使用し、パスワードは不要）
execute_mysql	MySQL／PolarDB に直接接続して SQL を実行します
execute_mongo	MongoDB に直接接続してコマンドを実行します
execute_redis	Tair／Redis に直接接続してコマンドを実行します
search_database	DMS 内のデータベースを検索します
execute_sql	DMS 経由で SQL を実行します
register_to_dms	インスタンスを DMS に登録します

クイックスタート

インストール

git clone http://gitlab.alibaba-inc.com/cloudmon/alibabacloud-yaochi-db-mcp-server.git
cd alibabacloud-yaochi-db-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install .

動作確認

yaochi-db-mcp-server

成功すると、stdio の待機モードに入ります（出力はありません）。終了するには Ctrl+C を押します。

AI クライアントの設定

AI クライアントの MCP 設定に追加します。

{
  "mcpServers": {
    "yaochi-db": {
      "command": "<project-path>/alibabacloud-yaochi-db-mcp-server/.venv/bin/yaochi-db-mcp-server",
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your-ak",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your-sk",
        "ALIBABA_CLOUD_REGION_ID": "cn-hangzhou",
        "YAOCHI_ENABLE_WRITE_SQL": "true",
        "YAOCHI_ENABLE_DDL_SQL": "true"
      }
    }
  }
}

環境変数

変数	デフォルト	説明
ALIBABA_CLOUD_ACCESS_KEY_ID	—	Alibaba Cloud AccessKey ID（必須）
ALIBABA_CLOUD_ACCESS_KEY_SECRET	—	Alibaba Cloud AccessKey Secret（必須）
ALIBABA_CLOUD_REGION_ID	cn-hangzhou	デフォルトのリージョン
YAOCHI_ENABLE_WRITE_SQL	true	INSERT／UPDATE／DELETE を許可します
YAOCHI_ENABLE_DDL_SQL	false	CREATE／ALTER DDL を許可します
YAOCHI_PUBLIC_IP	自動検出	パブリック IP を手動で指定します

セキュリティ機能

• 一時アカウント：SQL の実行ごとに一時的なデータベースアカウントを自動作成・削除するため、認証情報が永続しません
• SQL の安全性チェック：DROP／TRUNCATE などの危険な操作をブロックし、コメントと複数ステートメントを禁止します
• 制限付きホワイトリスト：既存のルールに影響を与えず、現在の IP のみによるパブリックアクセス（/32）を自動設定します
• 書き込み制御：環境変数を使用して DML／DDL 権限を細かく設定できます

使用例

User: Create a PolarDB MySQL cluster, build an orders table, and set up a Tair cache

AI automatically:
1. create_instance(engine="polardb-mysql")
   → Returns instance_id="pc-bp1xxx"

2. execute_instance_sql(instance_id="pc-bp1xxx", engine="polardb-mysql", database="testdb",
     sql="CREATE TABLE orders (id BIGINT PRIMARY KEY, amount DECIMAL(10,2))", force=true)
   → Auto-provisions public access + whitelist + creates DB + creates table

3. create_instance(engine="tair")
   → Returns instance_id="r-bp1xxx"

4. execute_redis(host="r-bp1xxx.redis.rds.aliyuncs.com", port=6379, password="xxx",
     command="SET order:1001 '{\"amount\":99.9}'")
   → OK

5. ask_yaochi_agent(query="PolarDB cluster pc-bp1xxx performance diagnosis")
   → Returns optimization suggestions from Yaochi Database Agent

ライセンス

Apache License 2.0

コントリビューション

Issue と Pull Request を歓迎します。

リンク

• MCP プロトコルのドキュメント
• Alibaba Cloud RAM コンソール
• DMS コンソール