local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Uses environment variables for configuration, allowing database credentials to be securely stored and accessed through a .env file.
Hosts the repository for the MCP server, enabling users to clone and install the server from GitHub.
Provides database interaction capabilities through MySQL, enabling SQL query execution, table management, schema analysis, and business intelligence generation with automatic insights creation.

zaj-MySQL-MCP

MySQL을 통해 데이터베이스 상호작용 및 비즈니스 인텔리전스 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 SQL 쿼리 실행, 비즈니스 데이터 분석, 비즈니스 인사이트 메모 자동 생성이 가능합니다.

특징

MySQL 데이터베이스에 대해 SQL 쿼리 실행
데이터베이스 테이블 생성 및 관리
데이터베이스 스키마 분석
비즈니스 통찰력을 생성하고 저장하세요
지속적으로 업데이트되는 비즈니스 인사이트 메모에 액세스하세요

도구

쿼리 도구

read_query : 데이터베이스에서 데이터를 읽기 위해 SELECT 쿼리를 실행합니다.
- 입력: query (문자열) - 실행할 SELECT SQL 쿼리
- 반환: 객체 배열로 쿼리 결과
write_query : INSERT, UPDATE 또는 DELETE 쿼리를 실행합니다.
- 입력: query (문자열) - SQL 수정 쿼리
- 반환: { affected_rows: number }
create_table : 데이터베이스에 새 테이블을 생성합니다
- 입력: query (문자열) - CREATE TABLE SQL 문
- 반환: 테이블 생성 확인

스키마 도구

list_tables : 데이터베이스의 모든 테이블 목록을 가져옵니다.
- 입력이 필요하지 않습니다
- 반환: 테이블 이름 배열
describe_table : 특정 테이블에 대한 스키마 정보 보기
- 입력: table_name (문자열) - 설명할 테이블의 이름
- 반환: 이름과 유형이 포함된 열 정의 배열

분석 도구

append_insight : 메모 리소스에 새로운 비즈니스 통찰력을 추가합니다.
- 입력: insight (문자열) - 데이터 분석을 통해 발견된 비즈니스 통찰력
- 반환: 통찰력 추가 확인
- memo://insights 리소스 업데이트를 트리거합니다.

자원

서버는 단일 리소스를 노출합니다.

memo://insights : 분석 중 발견된 통찰력을 집계하는 지속적으로 업데이트되는 비즈니스 통찰력 메모
- 추가 인사이트 도구를 통해 새로운 인사이트가 발견되면 자동으로 업데이트됩니다.

구현 세부 사항

이 MCP 서버는 외부 SDK 종속성에 의존하지 않고 모델 컨텍스트 프로토콜을 직접 구현합니다. 다음을 사용합니다.

mysql2 : MySQL 데이터베이스 연결용
yargs : 명령줄 인수 구문 분석을 위해
readline : stdin/stdout 통신을 처리하기 위한 것입니다.

서버는 Claude와 통신하기 위해 JSON-RPC 2.0 프로토콜을 따르며 도구 목록, 리소스 목록 및 도구 실행에 대한 요청을 처리합니다.

구성

MySQL MCP 서버는 환경 변수를 사용하여 구성합니다. 루트 디렉터리에 다음 변수를 사용하여 .env 파일을 생성하세요.

지엑스피1

.env.example 파일이 템플릿으로 제공됩니다. 이 파일을 .env 파일로 복사하고 값을 업데이트하세요.

cp .env.example .env
# Then edit .env with your database credentials

Claude Desktop과 함께 사용

cline_mcp_settings.json 에 서버를 추가합니다.

"mcpServers": {
  "mysql": {
    "command": "node",
    "args": [
      "/path/to/zaj_MySQL_MCP/build/index.js"
    ],
    "disabled": false,
    "autoApprove": []
  }
}

이제 데이터베이스 자격 증명은 명령줄 인수가 아닌 .env 파일을 통해 구성됩니다.

건물과 운영

저장소를 복제합니다.

git clone https://github.com/zajTools/zaj-MySQL-MCP.git
cd zaj-MySQL-MCP

.env 파일을 만들고 구성하세요.

cp .env.example .env
# Edit .env with your database credentials

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

서버를 실행합니다:

node build/index.js

데모 및 예제

MySQL MCP 서버를 시작하는 데 도움이 되는 예제 자료를 포함했습니다.

샘플 데이터베이스 : 고객, 제품, 주문 및 판매 데이터가 포함된 완전한 전자 상거래 데이터베이스 스키마
예제 쿼리 : MCP 서버의 다양한 기능을 보여주는 미리 작성된 쿼리
사용 시나리오 : Claude가 MySQL 데이터베이스와 상호 작용하는 방법의 예

데모를 시도하려면:

단계별 지침은 데모 가이드를 확인하세요.
샘플 데이터베이스를 생성하려면 설치 SQL 스크립트를 실행하세요.
데모 데이터베이스에 연결하도록 MCP 서버를 구성합니다.
클로드에게 귀하의 데이터에 대한 질문을 해보세요!

이러한 예제는 Claude를 MySQL 데이터베이스와 함께 사용할 경우의 잠재력을 보여주기 위해 설계되었지만, MCP 서버는 사용자가 액세스할 수 있는 모든 MySQL 데이터베이스에서 작동합니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

MySQL 연결을 통해 SQL 쿼리 실행, 데이터베이스 관리 및 비즈니스 인텔리전스 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server