Skip to main content
Glama
enesjakozh

MCP Alchemy

by runekaagaard
GitHub
Python
Mozilla Public License 2.0
324
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCPアルケミー

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

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

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

  • データベース構造の調査と理解に役立ちます

  • SQLクエリの作成と検証を支援する

  • テーブル間の関係を表示します

  • 大規模なデータセットを分析してレポートを作成する

  • Claude Desktop は、claude-local-filesを使用して、非常に大規模なデータセットを分析し、成果物を作成できます。

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

MCP Alchemy の活用

インストール

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.5.2.210242", "--refresh-package", "mcp-alchemy", "mcp-alchemy"], "env": { "DB_URL": "sqlite:////absolute/path/to/database.db" } } } }

PostgreSQL

{ "mcpServers": { "my_postgres_db": { "command": "uvx", "args": ["--from", "mcp-alchemy==2025.5.2.210242", "--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.5.2.210242", "--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.5.2.210242", "--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.5.2.210242", "--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.5.2.210242", "--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"], ...

私の他のLLMプロジェクト

  • MCP Redmine - Claude Desktop で Redmine プロジェクトと問題を管理します。

  • MCP Notmuch Sendmail - notmuch を使用した Claude Desktop の電子メール アシスタント。

  • Diffpilot - ファイルのグループ化とタグ付けが可能な複数列の Git 差分ビューア。

  • Claude ローカル ファイル- Claude デスクトップ アーティファクト内のローカル ファイルにアクセスします。

MCPディレクトリリスト

MCP Alchemy は、次の MCP ディレクトリ サイトおよびリポジトリにリストされています。

貢献

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

  • バグを報告したり機能を提案したりするには、問題を開いてください

  • 改善点を記載したプルリクエストを送信する

  • ドキュメントを充実させたり、使用例を共有したりする

  • 質問をして経験を共有しましょう

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

ライセンス

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Claude Desktop をデータベースに直接接続することで、テーブル探索およびクエリ実行ツールを備えた API レイヤーを通じて、データベース構造の探索、SQL クエリの記述、データセットの分析、レポートの作成が可能になります。

  1. インストール
    1. Claude Desktopでの使用
      1. SQLite（Pythonに組み込まれている）
      2. PostgreSQL
      3. MySQL/MariaDB
      4. マイクロソフトSQLサーバー
      5. オラクル
      6. クレートDB
    2. 環境変数
      1. API
        1. ツール
      2. クロード・ローカルファイル
        1. 現像
          1. 私の他のLLMプロジェクト
            1. MCPディレクトリリスト
              1. 貢献
                1. ライセンス

                  Related Resources

                  Related MCP Servers

                  • MCP-Python

                    rhabraken
                    -
                    security
                    F
                    license
                    -
                    quality
                    A server that enables interaction with PostgreSQL, MySQL, MariaDB, or SQLite databases through Claude Desktop using natural language queries.
                    Last updated -

                  • MCPDB - Database Access MCP Server

                    jantuitman
                    -
                    security
                    F
                    license
                    -
                    quality
                    Provides Claude Desktop with secure access to multiple database connections, allowing users to query MySQL, PostgreSQL, SQLite, and SQL Server databases directly through natural language.
                    Last updated -
                    • Apple

                  • MCP Database Server

                    JuanYin1
                    -
                    security
                    A
                    license
                    -
                    quality
                    Provides Claude with direct access to databases including SQLite, SQL Server, PostgreSQL, and MySQL, enabling execution of SQL queries and table management through natural language.
                    Last updated -
                    417
                    1
                    MIT License
                    • Apple
                    • Linux

                  • MCP Database Server

                    shailesh5050
                    -
                    security
                    A
                    license
                    -
                    quality
                    This server enables Claude to directly interact with SQLite, SQL Server, PostgreSQL, and MySQL databases through the Model Context Protocol, allowing for query execution, table management, and data export capabilities.
                    Last updated -
                    MIT License
                    • Apple
                    • Linux

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/runekaagaard/mcp-alchemy'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server