Schemity MCP Server認証済み注目

Schemity MCP Server とは？

Schemity MCP Server は、デスクトップ向けデータベース設計アプリ Schemity に組み込まれたローカルのデータベース MCP サーバーです。エージェントは Schemity で開いているダイアグラムを通じて PostgreSQL、MySQL、MariaDB、SQL Server、SQLite のスキーマを読み取り、マイグレーションを実行する前にその影響を確認し、あなたがレビューする編集をステージングします。

多くのデータベース MCP サーバーは、エージェントに接続文字列を渡して書いた SQL をそのまま実行します。Schemity はその逆で、エージェントは Schemity がデータベースから読み込んだダイアグラムを通じて作業し、データベースの認証情報を受け取ることはなく、何をしてもデータベースには書き込みません。読み取りは何も変更せず、編集はダイアグラム上の未保存の変更として反映され、データベースに触れるのはあなたが自分でマイグレーションを実行したときだけです。サーバーはクローズドソースのデスクトップアプリに同梱されており、GitHub リポジトリ tbson/schemity-mcp にはドキュメント、tools.json、ホスト設定の例があります。

Schemity MCP Server の使い方

1. macOS、Windows、Linux のいずれかに Schemity をインストールします。
2. エージェントに見せたいダイアグラムを開きます。サーバーが見られるのは Schemity のウィンドウで開いているダイアグラムで、ディスク上のファイルではありません。
3. コントロールバーのプラグアイコン、または Cmd+Shift+A（macOS）/ Ctrl+Shift+A（Windows、Linux）で MCP パネルを開きます。サーバーのステータス、接続テスト、各ホスト向けにプラットフォームに合ったパス入りのスニペットが表示されます。

以下の例は macOS のパスを使っています。Windows と Linux では MCP パネルからスニペットをコピーしてください。

ホストの接続方法は 2 通りです。stdio ホストは --mcp 付きで Schemity のバイナリを起動するため、Schemity が閉じていても起動できます。HTTP ホストはパネルの bearer token を使って http://127.0.0.1:7332/mcp に接続し、Schemity をあらかじめ開いておく必要があります。

Claude Code

claude mcp add --scope user schemity -- "/Applications/Schemity.app/Contents/MacOS/schemity" --mcp

以前の HTTP コマンドで Claude Code に登録していた場合は、先に claude mcp remove --scope user schemity を実行してください。

Claude Desktop

claude_desktop_config.json に次を追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "schemity": {
      "command": "/Applications/Schemity.app/Contents/MacOS/schemity",
      "args": ["--mcp"]
    }
  }
}

Cursor

Schemity を開いたままにします。MCP パネルからコピーしたトークンを使って ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "schemity": {
      "url": "http://127.0.0.1:7332/mcp",
      "headers": { "Authorization": "Bearer <token from the MCP panel>" }
    }
  }
}

Codex

~/.codex/config.toml に追加します。

[mcp_servers.schemity]
command = "/Applications/Schemity.app/Contents/MacOS/schemity"
args = ["--mcp"]

OpenCode では opencode.json に同じコマンドと --mcp を指定した local エントリを書きます。

Schemity MCP Server の主な機能

• PostgreSQL、Supabase、MySQL、MariaDB、SQL Server、SQLite に、直接または SSH トンネル経由で対応。
• エージェントがデータベースの認証情報を受け取ることはありません。
• マイグレーション実行前の影響分析：データ損失、既存行で失敗するステートメント、テーブルの書き換え、大きなテーブルのロック、依存するビューや関数。
• 手書き、または Prisma、Alembic、Flyway が生成したマイグレーションファイルを実行せずに分析。
• エージェントの編集は未保存の変更としてステージングされ、エージェント名付きで元に戻す履歴に記録されます。
• 削除を含むプランは事前に確認され、どのエージェントが何を削除しようとしているかが表示されます。
• ベンダーのクラウドを経由しません。HTTP サーバーは 127.0.0.1 のみで待ち受け、bearer token は OS のキーチェーンに保存されます。

Schemity MCP Server のツール

Schemity 2.11.2 は 16 個のツールを提供します。

• 読み取りツール（何も変更しない）：open_schemity はアプリを起動または前面に表示し、list_diagrams（最初に呼ぶ）、get_schema、get_context_views は開いているダイアグラムを説明します。get_dependencies はエンティティへの入出力の関係を示し、get_data_dictionary はドキュメント化されたスキーマを Markdown で返し、lint は命名規約、インデックスの欠落、型の不一致を報告します。
• マイグレーションの影響：get_pending_changes、analyze_impact、analyze_migration_file、そして依頼したときに読み取り専用クエリで正確な件数を数える count_rows。
• 視覚的なレビュー：check_relation_lines は重なったり交差したりしている線を見つけ、show_preview は提案された変更を使い捨ての読み取り専用キャンバスに描きます。
• ステージングされる編集：propose_changes はエンティティ、フィールド、リレーション、凡例、コンテキストビューを作成・変更・削除し、group_entities はエンティティを凡例にまとめ、route_relations は交差が減るようにリレーション線を引き直します。

Schemity MCP Server のユースケース

• マージ前のマイグレーションレビュー：「この Prisma のマイグレーションファイルを分析して、既存行で失敗するステートメントを教えて。」
• スキーマの把握：「ダイアグラムを一覧して、orders と invoices テーブルの関係を説明して。」
• スキーマ設計：「users に紐づく audit_log テーブルを追加して」と頼み、Schemity でステージングされた変更をレビューして保存または取り消し。
• ドキュメント化：「このダイアグラムのデータディクショナリを Markdown で出力して。」
• 整理：「lint を実行して、見つかったインデックスの欠落を直して。」

Schemity MCP Server のトラブルシューティング

• 「Schemity is not running」：アプリを起動できるのは stdio ホストだけです。Cursor などの HTTP ホストでは、自分で Schemity を開いてから再試行してください。
• 401 Unauthorized：パネルでトークンが再生成されました。現在のトークンをホストの設定にコピーしてください。
• ポートが使用中：MCP パネルで別のポートを選び、Restart をクリックします。
• ツールがダイアグラムを「not open」と言う：そのダイアグラムを Schemity のウィンドウで開いてください。