fastmcp-sqltools

FastMCP SQL Tools

mcp-name: io.github.atarkowska/fastmcp-sqltools

FastMCP で構築された Model Context Protocol（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 ファイルを参照してください。