OceanBase MCP 서버
OceanBase 데이터베이스와의 안전한 상호작용을 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 비서가 제어된 인터페이스를 통해 테이블을 나열하고, 데이터를 읽고, SQL 쿼리를 실행할 수 있으므로 데이터베이스 탐색 및 분석이 더욱 안전하고 체계적으로 이루어집니다.
특징
- 사용 가능한 OceanBase 테이블을 리소스로 나열합니다.
- 표의 내용을 읽어보세요
- 적절한 오류 처리를 통해 SQL 쿼리 실행
- 환경 변수를 통한 안전한 데이터베이스 액세스
- 종합 로깅
설치
지엑스피1
구성
다음 환경 변수를 설정하세요.
OB_HOST=localhost # Database host
OB_PORT=2881 # Optional: Database port (defaults to 2881 if not specified)
OB_USER=your_username
OB_PASSWORD=your_password
OB_DATABASE=your_database
용법
클로드 데스크톱과 함께
claude_desktop_config.json 에 다음을 추가하세요:
{
"mcpServers": {
"oceanbase": {
"command": "uv",
"args": [
"--directory",
"path/to/oceanbase_mcp_server",
"run",
"oceanbase_mcp_server"
],
"env": {
"OB_HOST": "localhost",
"OB_PORT": "2881",
"OB_USER": "your_username",
"OB_PASSWORD": "your_password",
"OB_DATABASE": "your_database"
}
}
}
}
독립형 서버로서
# Install dependencies
pip install -r requirements.txt
# Run the server
python -m oceanbase_mcp_server
개발
# Clone the repository
git clone https://github.com/yourusername/oceanbase_mcp_server.git
cd oceanbase_mcp_server
# Create virtual environment
python -m venv venv
source venv/bin/activate # or `venv\Scripts\activate` on Windows
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
pytest
보안 고려 사항
- 환경 변수나 자격 증명을 커밋하지 마십시오.
- 최소한의 필수 권한이 있는 데이터베이스 사용자를 사용하세요
- 프로덕션 사용을 위해 쿼리 허용 목록을 구현하는 것을 고려하세요.
- 모든 데이터베이스 작업을 모니터링하고 기록합니다.
보안 모범 사례
이 MCP 서버가 작동하려면 데이터베이스 액세스가 필요합니다. 보안을 위해:
- 최소한의 권한으로 전담 OceanBase 사용자를 만듭니다.
- 루트 자격 증명이나 관리 계정을 사용하지 마십시오.
- 필요한 작업에만 데이터베이스 액세스를 제한합니다.
- 감사 목적으로 로깅을 활성화합니다 .
- 데이터베이스 접근에 대한 정기적인 보안 검토
자세한 지침은 OceanBase 보안 구성 가이드를 참조하세요.
- 제한된 OceanBase 사용자 생성
- 적절한 권한 설정
- 데이터베이스 액세스 모니터링
- 보안 모범 사례
⚠️ 중요: 데이터베이스 액세스를 구성할 때는 항상 최소 권한 원칙을 따르세요.
특허
Apache 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.
기여하다
- 저장소를 포크하세요
- 기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature ) - 변경 사항을 커밋하세요(
git commit -m 'Add some amazing feature' ) - 브랜치에 푸시(
git push origin feature/amazing-feature ) - 풀 리퀘스트 열기