Fastmcp Sqltools

🚀 FastMCP SQL Tools

FastMCPを用いて構築されたModel Context Protocol (MCP)サーバーで、PostgreSQL、MySQL、SQLiteをサポートするSQLデータベースへのアクセスを提供します。

🚀 クイックスタート

FastMCP SQL Toolsは、FastMCPを基盤としたMCPサーバーで、PostgreSQL、MySQL、SQLiteに対応したSQLデータベースへのアクセスを可能にします。

✨ 主な機能

• list_tables：データベース内の全テーブルをリストアップします。
• get_table_schema：テーブルの詳細なスキーマ情報（列、型、制約、インデックスを含む）を取得します。
• execute_query：任意のSQLクエリ（INSERT、UPDATE、DELETE、DDLなど）を実行します。
• execute_safe_query：追加の安全チェック付きで読み取り専用のSELECTクエリを実行します。

📦 インストール

サポートされるデータベース

• PostgreSQL：asyncpgを通じた完全サポート
• MySQL：aiomysqlを通じた完全サポート
• SQLite：aiosqliteを通じた完全サポート

サーバーは、DATABASE_URL環境変数からデータベースの種類を自動的に検出します。

設定

claude_desktop_config.jsonに以下を追加してください。

{
    "mcpServers": {
        "sql-mcp-tools": {
            "command": "uvx",
            "args": [
                "fastmcp-sqltools"
            ],
            "env": {
                "DATABASE_URL": "<your-database-url>"
            }
        }
    }
}

データベースURLの形式

DATABASE_URLは以下の形式のいずれかである必要があります。

• PostgreSQL：postgresql://user:password@host:port/database または postgres://user:password@host:port/database
• MySQL：mysql://user:password@host:port/database
• SQLite：sqlite:///path/to/database.db（絶対パスの場合は3つのスラッシュを使用）

📄 ライセンス

このプロジェクトはGNU Affero General Public License v3.0 (AGPL - 3.0)の下でライセンスされています。詳細はLICENSEファイルを参照してください。