DB Planner

DB Planner MCP サーバー

DB Planner のホスト型 MCP サーバーです。あらゆる MCP クライアントから、データベーススキーマ（DBML／SQL）、Mermaid の図、ボードレイアウトを編集できます。OAuth でサインインするだけで、インストールは不要です。

https://api.dbplanner.io/mcp

このリポジトリはドキュメントです。サーバーは DB Planner API に組み込まれているため、実行するコードはありません。URL をクライアントに追加し、ブラウザーで一度サインインすれば、エージェントからプロジェクトに対して 38 個のツールを利用できます。

DB Planner とは

DB Planner は、共同で使えるデータベース設計ツールです。DBML でスキーマを記述するか、SQL ダンプ（PostgreSQL、MySQL、SQL Server）をインポートし、Mermaid で図を描きます。さらに、それらを共有ボード上に配置すると、リレーション、メモ、描画がリアルタイムで表示されます。テンプレートマーケットプレイスでは、公開されたスキーマを共有できます。

接続

Claude Code

claude mcp add --transport http db-planner https://api.dbplanner.io/mcp

Cursor および JSON 設定を使うその他のクライアント

{
  "mcpServers": {
    "db-planner": {
      "type": "http",
      "url": "https://api.dbplanner.io/mcp"
    }
  }
}

url はどのクライアントでも同じですが、type の値は異なります。Claude Code の .mcp.json では上記のように http を指定します。Cursor の .cursor/mcp.json では type は不要で、Cline の mcp.json では streamableHttp を指定します。リモートサーバーの設定形式については、使用するクライアントのドキュメントを確認してください。

Claude.ai と Claude Desktop

「設定」から「コネクタ」を選び、「カスタムコネクタを追加」を選択します。URL を貼り付けます。認証は「常に必須」、OAuth クライアントは「自動的に登録」を選択します。ヘッダーは不要です。

MCP Inspector

npx @modelcontextprotocol/inspector

「Add Servers」をクリックし、フォームに入力します。サーバー ID は db-planner、トランスポートは streamable-http、URL は https://api.dbplanner.io/mcp です。追加して有効にすると、ブラウザーで同意画面が開きます。

どのクライアントでも、最初のツール呼び出し時に DB Planner の同意画面が開きます。サインインしてスコープを選択すれば接続完了です。パスワードや API キーがクライアント設定に保存されることはありません。代わりに設定を行うエージェントには、llms-install.md を参照させてください。

認証

エンドポイントは PKCE を使用した OAuth 2.1 で保護されています。ディスカバリーは標準方式のため、クライアントは URL だけで設定できます。

• https://api.dbplanner.io/.well-known/openid-configuration
• https://api.dbplanner.io/.well-known/oauth-protected-resource
• 公開クライアント（token_endpoint_auth_method=none）と機密クライアント（client_secret_post、client_secret_basic）の両方に対応する、https://api.dbplanner.io/connect/register での動的クライアント登録

権限モデルは 2 つのスコープのみで構成され、その適用はクライアントではなくサーバー側で行われます。

スコープ	付与される権限
dbplanner:read	すべての読み取りツール。エンドポイントが必須としているため、常に付与されます。
dbplanner:write	変更を行うツール。ツールごとに確認されます。公開マーケットプレイスへの公開も含まれます。

MCP クライアントは両方のスコープを要求します。読み取り権限は常に付与され、書き込み権限は同意画面のチェックボックスで設定します。デフォルトではオンです。オフにすると、クライアントが要求していても書き込み権限なしでトークンが発行されます。そのため、読み取り専用接続はクライアント側の便宜的な制限ではなく、確実に保証されます。

クライアントは offline_access も要求します。これは権限ではなくセッションの仕組みです。更新トークンが発行されるため、トークンの有効期限が切れても接続を維持できます。要求された場合は常に付与されます。

ツールが参照できるのは、サインインしたユーザーがアプリで参照できる範囲に限られます。組織とプロジェクトのロールはトークンの subject から判定され、Web アプリが使用するものと同じサービスによって適用されます。

ツール

各ツールには、タイトル、読み取り専用または破壊的操作を示すヒント、false の openWorldHint、すべてのパラメーターの説明、出力スキーマが用意されています。そのため、クライアントは確認プロンプトなしで読み取りを実行し、テキストを解析する代わりに構造化された結果を取得できます。

グループ	読み取り	書き込み
セッション	whoami、get_public_profiles
組織	list_orgs、get_org	create_org、rename_org、delete_org、upsert_org_member、remove_org_member
プロジェクト	list_projects	create_project、update_project、delete_project、upsert_project_member、remove_project_member
ドキュメント	list_documents、list_diagrams	create_document、update_document、delete_document、reorder_documents、set_table_color
ボード	get_board、get_board_image、list_tables、list_drawings	update_board、draw、draw_shape、erase_drawings、add_board_image
マーケットプレイス	browse_templates、get_template、list_my_listings	use_template、publish_listing、update_listing、unpublish_listing

エージェントがツールを呼び出す前に知っておくとよい点をいくつか紹介します。

• 設計はドキュメント内に記述し、ボードには記述しません。 テーブル、列、参照、列挙型、クラス、フローチャートのステップは、ドキュメントを解析して生成されます。そのため、設計の変更には create_document と update_document を使い、ボードはそれに追従します。テーブルを直接作成するツールはありません。
• get_board_image はボードを PNG にレンダリングします。 モデルは座標から推測するのではなく、レイアウトを確認できます。ベクターソースをテキストで取得するには、format='svg' を渡します。
• draw と draw_shape は描画ツールです。 インクと矢印には kind を指定する1つのツールを使います。長方形、ひし形、楕円には、任意のバインドされたテキストを指定できるもう1つのツールを使います。どちらも ID を生成し、アプリと同じ方法で座標を丸めます。単独のフリーテキスト、グループ、リンクは update_board で操作します。
• update_board は部分的な差分を受け取ります。 変更するカード ID だけを送信してください。値に null を指定すると、そのカードが削除されます。これはアプリと同じマージ仕様なので、エージェントが1つのカードを移動しても、共同作業者のレイアウトを上書きしません。
• 公開できるのは作成者のみで、価格を指定するツールはありません。 プロジェクトを出品できるのは、そのプロジェクトを作成したユーザーだけです。また、MCP 経由で公開される出品は常に無料です。価格設定には Stripe のオンボーディングが必要ですが、他の人に代わって手続きすることはできません。

掲載先

• Official MCP Registry に io.dbplanner/db-planner として掲載
• Smithery
• Glama
• mcp.so
• cursor.directory

サポート

ご質問や問題については、[email protected] までお問い合わせください。製品ドキュメントは dbplanner.io/features にあります。

ライセンス

このドキュメントは MIT License の下で公開されています。DB Planner 自体はホステッド製品です。詳しくは dbplanner.io/pricing をご覧ください。