SQL Schema MCP Server

MySQLスキーマファイルをHTTP経由でMCP (Model Context Protocol) サーバーとして提供するツールです。

クイックスタート

1. ビルド

go build -o schemamcp .

2. 設定ファイル作成

config.yaml を作成：

databases:
  - name: main
    type: mysql
    schema_file: ./schemas/main.sql
    description: メインデータベース

3. 起動

# HTTPサーバーとして起動 (デフォルトポート: 8082)
./schemamcp

# カスタム設定ファイルを指定
./schemamcp -config /path/to/config.yaml

起動後、http://localhost:8082/mcp でMCPサーバーにアクセス可能になります。

MCPクライアント設定

Claude Code での利用

.mcp.json を作成：

{
  "mcpServers": {
    "sql-schema": {
      "transport": "http",
      "url": "http://localhost:8082/mcp"
    }
  }
}

提供機能

Tools

• list_tables: 全テーブル一覧を取得
• get_table_schema: 特定テーブルのスキーマ情報を取得
• search_schema: テーブル・カラム・コメントからキーワード検索

Resources

• schema://overview: 全データベース・テーブルの概要
• schema://table/{db}/{table}: 特定テーブルの詳細情報

使用例

# テーブル一覧を表示
list_tablesツールを使って、全テーブルを表示してください

# 特定テーブルのスキーマを取得
usersテーブルのスキーマを教えてください

# キーワード検索
「QR」に関連するテーブルを検索してください

対応SQL構文

• CREATE TABLE 文
• カラム定義（型、NOT NULL、DEFAULT、COMMENT）
• PRIMARY KEY, UNIQUE KEY, INDEX
• テーブルコメント

未対応: 外部キー制約、CHECK制約、トリガー、ビュー

ライセンス

MIT