@yuuzu/sql Mcp

@yuuzu/sql-mcp

MSSQL、PostgreSQL、SQLite のデータベース操作に対応する Model Context Protocol（MCP）サーバーです。

インストール

# Using bunx (recommended)
bunx @yuuzu/sql-mcp

# Using npx
npx @yuuzu/sql-mcp

機能

• マルチデータベース対応：MSSQL、PostgreSQL、SQLite（better-sqlite3 経由）
• データベース操作用の8 つのツール
• 3 つのクエリモード：safe、write、full
• 高度な認証：Windows 認証（MSSQL）、SSL 証明書（PostgreSQL）

ツール

ツール	説明
connect-database	データベースサーバーに接続します
disconnect	現在の接続を切断します
connection-status	接続状態とクエリモードを確認します
list-databases	サーバー上のすべてのデータベースを一覧表示します
switch-database	別のデータベースに切り替えます
list-tables	すべてのテーブルとビューを一覧表示します
describe-table	テーブルスキーマの詳細を取得します
execute-query	SQL クエリを実行します

クエリモード

SQL_MCP_MODE 環境変数でクエリの権限を制御します。

モード	許可される操作	説明
safe（デフォルト）	SELECT、WITH、EXPLAIN	読み取り専用で、最も安全です
write	+ INSERT、UPDATE、DELETE	データの変更が可能です
full	+ CREATE、DROP、ALTER、TRUNCATE	フルアクセスです。使用には注意してください

注： PRAGMA 文（例：PRAGMA table_info(users)）は、SQLite でよく使われる読み取り専用のメタデータクエリであるため、safe を含むすべてのモードで許可されます。

# Example: Enable write mode
SQL_MCP_MODE=write bunx @yuuzu/sql-mcp

使用例

Claude Desktop の設定

claude_desktop_config.json に追加します。

{
    "mcpServers": {
        "sql-mcp": {
            "command": "bunx",
            "args": ["@yuuzu/sql-mcp"],
            "env": {
                "SQL_MCP_MODE": "safe"
            }
        }
    }
}

MSSQL に接続する

{
    "tool": "connect-database",
    "arguments": {
        "engine": "mssql",
        "server": "localhost",
        "port": 1433,
        "user": "sa",
        "password": "your_password",
        "database": "master"
    }
}

PostgreSQL に接続する

{
    "tool": "connect-database",
    "arguments": {
        "engine": "postgres",
        "server": "localhost",
        "port": 5432,
        "user": "postgres",
        "password": "your_password",
        "database": "postgres"
    }
}

Windows 認証で接続する（MSSQL）

{
    "tool": "connect-database",
    "arguments": {
        "engine": "mssql",
        "server": "localhost",
        "windowsAuth": true
    }
}

SSL で接続する（PostgreSQL）

{
    "tool": "connect-database",
    "arguments": {
        "engine": "postgres",
        "server": "your-server.com",
        "user": "postgres",
        "password": "your_password",
        "ssl": {
            "rejectUnauthorized": true,
            "ca": "/path/to/ca-certificate.crt"
        }
    }
}

SQLite に接続する（ファイル）

{
    "tool": "connect-database",
    "arguments": {
        "engine": "sqlite",
        "filename": "/absolute/path/to/database.db"
    }
}

SQLite に接続する（インメモリ）

テスト、デモ、一時的なスクラッチワークスペースに便利です。

{
    "tool": "connect-database",
    "arguments": {
        "engine": "sqlite",
        "filename": ":memory:"
    }
}

SQLite に接続する（読み取り専用）

{
    "tool": "connect-database",
    "arguments": {
        "engine": "sqlite",
        "filename": "/absolute/path/to/database.db",
        "readonly": true,
        "fileMustExist": true
    }
}

SQLite のランタイムに関する注意： SQLite のサポートでは Node.js が必要な better-sqlite3 を使用します。bunx 経由で実行する場合、MSSQL と PostgreSQL は通常どおり動作しますが、SQLite 接続では npx または node を使用するよう案内する明確なエラーが返されます。

開発

# Install dependencies
bun install

# Run in development mode
bun run dev

# Run tests
bun test

# Run tests with coverage
bun test --coverage

# Build
bun run build

# Type check
bun run typecheck

リリース

リリースは GitHub Actions によって自動化されています。新しいリリースを作成するには、次の手順を実行します。

# Create and push a version tag
git tag v1.0.0
git push origin v1.0.0

これにより、次の処理が行われます。

1. プロジェクトをビルドします
2. provenance 付きで npm に公開します
3. 自動生成されたリリースノートを含む GitHub Release を作成します

要件：GitHub リポジトリの設定で NPM_TOKEN シークレットを設定してください。

ライセンス

MIT