🤖
これから始めるTiDB + AI 2026 Spring

2026/02/27に公開
 はじめにTiDBは手軽に使えるデータベースというだけではなく、AIエージェントからも簡単に利用することができます。この記事ではAIからTiDBを利用する方法を紹介します。

 TiDB Cloud Zero最近できた実験的なサービスで、curlやAIエージェントからTiDBクラウドのクラスタを作り、利用できるものです。サインアップ不要で、curlコマンドを実行するだけで利用できるようになります。やってみましょう。
https://zero.tidbcloud.com/?code=TIPLANET
$ curl -X POST https://zero.tidbapi.com/v1alpha1/instances

{"instance":{"connection":{"host":"gateway01.us-west-2.prod.aws.tidbcloud.com","port":4000,"username":"XXXXX.root","password":"XXXXXXXXXXX"},"connectionString":"mysql://XXXXX.root:XXXXXXXXXXX@gateway01.us-west-2.prod.aws.tidbcloud.com:4000/","expiresAt":"2026-03-29T02:40:11.551Z"}}%

このような形で、JSONで接続文字列が返ってくるので、これでmysqlクライアントから接続することができます。
Claude Codeなどのエージェントならもっと簡単に、URLからskillを読み取って実行するだけです。

❯ Read https://zero.tidbcloud.com/SKILL.md and follow the instructions to create a database using TiDB Cloud Zero.

⏺ Fetch(https://zero.tidbcloud.com/SKILL.md)
  ⎿  Received 4.3KB (200 OK)

⏺ Let me get the full raw content with exact details.

⏺ Fetch(https://zero.tidbcloud.com/SKILL.md)
  ⎿  Received 4.3KB (200 OK)

⏺ Now I have what I need. Let me provision a TiDB Cloud Zero database.

⏺ Bash(curl -s -X POST https://zero.tidbapi.com/v1alpha1/instances -H "Content-Type: application/json" -d '{"tag":
      "claude-code-session"}')
  ⎿  {
       "instance": {
         "connection": {
     … +9 lines (ctrl+o to expand)

⏺ The database has been provisioned. Let me save the credentials to a local file and verify the connection.

⏺ Bash(mysql -h gateway01.us-west-2.prod.aws.tidbcloud.com -P 4000 -u 'XXXXX.root' -p'XXXXXXXXXXX' --ssl-mode=REQUIRED
       -e "SELECT VERSION(); SHOW DATABA…)
  ⎿  mysql: [Warning] Using a password on the command line interface can be insecure.
     VERSION()
     8.0.11-TiDB-v8.5.3-serverless
     … +5 lines (ctrl+o to expand)

⏺ The TiDB Cloud Zero database is up and running. Here's a summary:
データベースの作成から、接続、クエリの実行まで、全てAIエージェントに任せることができました。

 MCP ServerTiDBでは、TiDBに接続するためのpythonライブラリpytidbを提供しています。

その機能の一つとして、MCP Serverを提供しています。
Claude Codeからなら、下記のようになファイルを.mcp.jsonとしてプロジェクトルートに置くことで、使うことができます。
{
  "mcpServers": {
    "TiDB": {
      "command": "uvx",
      "args": [
        "--from",
        "pytidb[mcp]",
        "tidb-mcp-server"
      ],
      "env": {
        "TIDB_HOST": "gateway01.ap-northeast-1.prod.aws.tidbcloud.com",
        "TIDB_PORT": "4000",
        "TIDB_USERNAME": "XXXXX.root",
        "TIDB_PASSWORD": "XXXXX",
        "TIDB_DATABASE": "test"
      }
    }
  }
}
先程のTiDB Cloud Zeroで作成したデータベースの接続情報を元に、この形式で.mcp.jsonを作成するようClaude Codeに指示してもよいでしょう。

 TiDB SkillsTiDBでは、TiDB固有の型や機能の知識を備えたSkillsも提供しています。
https://github.com/pingcap/agent-rules
次のように、プロジェクトのskillsディレクトリにTiDBのスキルを追加することができます。
npx skills add pingcap/agent-rules
SkillsにはTiDBの操作だけではなく、pytidbを用いたPythonコードの生成も含まれているため、TiDBを使ったAIアプリケーションの作成などもスムーズです。
是非使ってみてください！
はじめに

TiDB Cloud Zero

MCP Server

TiDB Skills

Discussion
