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가 설치되어 있는지 확인하세요:

지엑스피1

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"
      }
    }
  }
}

포스트그레스큐엘

{
  "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/마리아DB

{
  "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"],
...

기여하다

여러분의 참여를 진심으로 환영합니다! 버그 리포트, 기능 요청, 문서 개선, 코드 기여 등 모든 의견은 소중합니다. 자유롭게 다음 내용을 남겨주세요.

버그를 보고하거나 기능을 제안하려면 문제를 열어주세요.
개선 사항을 포함한 풀 리퀘스트 제출
문서를 개선하거나 사용 예를 공유하세요
질문을 하고 경험을 공유하세요

목표는 클로드와 데이터베이스의 상호작용을 더욱 개선하는 것이며, 여러분의 통찰력과 기여가 그 목표 달성에 도움이 될 것입니다.

특허

모질라 퍼블릭 라이센스 버전 2.0

내 다른 LLM 프로젝트

MCP Redmine - Claude Desktop에서 Redmine 프로젝트와 이슈를 관리하세요.
MCP Notmuch Sendmail - Notmuch를 사용하는 Claude Desktop용 이메일 도우미입니다.
Diffpilot - 파일 그룹화 및 태그 지정 기능을 갖춘 다중 열 git diff 뷰어입니다.
Claude Local Files - Claude Desktop 아티팩트의 로컬 파일에 액세스합니다.

MCP Alchemy

Integrations