MCPアルケミー

ステータス: 正常に動作し、既知のバグもなく毎日使用されています。

ステータス2: パッケージをPyPIに追加し、使用方法を更新しました。何か問題があればご報告ください :)

Claude をデータベースのエキスパートにしましょう! MCP Alchemy は Claude Desktop をデータベースに直接接続し、次のことを可能にします:

データベース構造の調査と理解に役立ちます
SQLクエリの作成と検証を支援する
テーブル間の関係を表示します
大規模なデータセットを分析してレポートを作成する
Claude Desktop は、claude-local-filesを使用して、非常に大規模なデータセットを分析し、成果物を作成できます。

PostgreSQL、MySQL、MariaDB、SQLite、Oracle、MS SQL Server、CrateDB、およびその他の多数のSQLAlchemy 互換データベースで動作します。

インストール

uv がインストールされていることを確認してください:

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

Claude Desktopでの使用

claude_desktop_config.jsonに追加してください。-- --withパラメータに適切なデータベースドライバーを追加する必要があります。

注: 新バージョンのリリース後、ローカルキャッシュがクリアされるまで最大600秒かかる場合があります。この間、UVはバージョン管理エラーを発生させます。MCPクライアントを再起動すると、エラーは解決されます。

SQLite（Pythonに組み込まれている）

{
  "mcpServers": {
    "my_sqlite_db": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003",
               "--refresh-package", "mcp-alchemy", "mcp-alchemy"],
      "env": {
        "DB_URL": "sqlite:///path/to/database.db"
      }
    }
  }
}

PostgreSQL

{
  "mcpServers": {
    "my_postgres_db": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003", "--with", "psycopg2-binary",
               "--refresh-package", "mcp-alchemy", "mcp-alchemy"],
      "env": {
        "DB_URL": "postgresql://user:password@localhost/dbname"
      }
    }
  }
}

MySQL/MariaDB

{
  "mcpServers": {
    "my_mysql_db": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003", "--with", "pymysql",
               "--refresh-package", "mcp-alchemy", "mcp-alchemy"],
      "env": {
        "DB_URL": "mysql+pymysql://user:password@localhost/dbname"
      }
    }
  }
}

マイクロソフトSQLサーバー

{
  "mcpServers": {
    "my_mssql_db": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003", "--with", "pymssql",
               "--refresh-package", "mcp-alchemy", "mcp-alchemy"],
      "env": {
        "DB_URL": "mssql+pymssql://user:password@localhost/dbname"
      }
    }
  }
}

オラクル

{
  "mcpServers": {
    "my_oracle_db": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003", "--with", "cx_oracle",
               "--refresh-package", "mcp-alchemy", "mcp-alchemy"],
      "env": {
        "DB_URL": "oracle+cx_oracle://user:password@localhost/dbname"
      }
    }
  }
}

クレートDB

{
  "mcpServers": {
    "my_cratedb": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003", "--with", "sqlalchemy-cratedb>=0.42.0.dev1",
               "--refresh-package", "mcp-alchemy", "mcp-alchemy"],
      "env": {
        "DB_URL": "crate://user:password@localhost:4200/?schema=testdrive"
      }
    }
  }
}

CrateDB Cloud に接続するには、 crate://user:password@example.aks1.westeurope.azure.cratedb.net:4200?ssl=trueのような URL を使用します。

環境変数

DB_URL : SQLAlchemyデータベースの URL (必須)
CLAUDE_LOCAL_FILES_PATH : 完全な結果セットのディレクトリ（オプション）
EXECUTE_QUERY_MAX_CHARS : 最大出力長（オプション、デフォルトは4000）

API

ツール

すべてのテーブル名
- データベース内のすべてのテーブル名を返す
- 入力不要
- カンマ区切りのテーブルリストを返す GXP8
フィルターテーブル名
- 部分文字列に一致するテーブルを検索する
- 入力: q (文字列)
- 一致するテーブル名を返す GXP9
スキーマ定義
- 指定されたテーブルの詳細なスキーマを取得する
- 入力: table_names (string[])
- 以下を含むテーブル定義を返します:
  - 列名と型
  - 主キー
  - 外部キー関係
  - NULL可能フラグ GXP10
クエリ実行
- 垂直出力形式でSQLクエリを実行する
- 入力:
  - query (文字列): SQLクエリ
  - params (オブジェクト、オプション): クエリパラメータ
- 結果をきれいな縦書き形式で返します: GXP11
- 特徴：
  - 大きな結果をスマートに切り捨てる
  - claude-local-files統合による完全な結果セットへのアクセス
  - クリーンなNULL値の表示
  - ISO形式の日付
  - 明確な列の分離

クロード・ローカルファイル

claude-local-filesが設定されている場合:

Claude のコンテキストウィンドウを超えて完全な結果セットにアクセスする
詳細なレポートと視覚化を生成する
大規模なデータセットの詳細な分析を実行する
結果をエクスポートしてさらに処理する

CLAUDE_LOCAL_FILES_PATHが設定されると、統合は自動的にアクティブになります。

現像

まず、github リポジトリをクローンし、依存関係と選択したデータベースドライバーをインストールします。

git clone git@github.com:runekaagaard/mcp-alchemy.git
cd mcp-alchemy
uv sync
uv pip install psycopg2-binary

次に、claude_desktop_config.json で以下を設定します。

...
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-alchemy", "-m", "mcp_alchemy.server", "main"],
...

貢献

貢献は大歓迎です！バグ報告、機能リクエスト、ドキュメントの改善、コードへの貢献など、あらゆるご意見が貴重です。ぜひお気軽にご連絡ください。

バグを報告したり機能を提案したりするには、問題を開いてください
改善点を記載したプルリクエストを送信する
ドキュメントを充実させたり、使用例を共有したりする
質問をして経験を共有しましょう

目標は、Claude とのデータベースのやりとりをさらに改善することであり、あなたの洞察と貢献がその達成に役立ちます。

ライセンス

Mozilla パブリックライセンスバージョン 2.0

私の他のLLMプロジェクト

MCP Redmine - Claude Desktop で Redmine プロジェクトと問題を管理します。
MCP Notmuch Sendmail - notmuch を使用した Claude Desktop の電子メールアシスタント。
Diffpilot - ファイルのグループ化とタグ付けが可能な複数列の Git 差分ビューア。
Claude ローカルファイル- Claude デスクトップアーティファクト内のローカルファイルにアクセスします。

MCP Alchemy

Integrations