OceanBase MCP 서버

OceanBase 데이터베이스와의 안전한 상호작용을 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 비서가 제어된 인터페이스를 통해 테이블을 나열하고, 데이터를 읽고, SQL 쿼리를 실행할 수 있으므로 데이터베이스 탐색 및 분석이 더욱 안전하고 체계적으로 이루어집니다.

특징

• 사용 가능한 OceanBase 테이블을 리소스로 나열합니다.

• 표의 내용을 읽어보세요

• 적절한 오류 처리를 통해 SQL 쿼리 실행

• 환경 변수를 통한 안전한 데이터베이스 액세스

• 종합 로깅

Related MCP server: Microsoft SQL Server MCP Server

설치

지엑스피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 서버가 작동하려면 데이터베이스 액세스가 필요합니다. 보안을 위해:

1. 최소한의 권한으로 전담 OceanBase 사용자를 만듭니다.

2. 루트 자격 증명이나 관리 계정을 사용하지 마십시오.

3. 필요한 작업에만 데이터베이스 액세스를 제한합니다.

4. 감사 목적으로 로깅을 활성화합니다 .

5. 데이터베이스 접근에 대한 정기적인 보안 검토

자세한 지침은 OceanBase 보안 구성 가이드를 참조하세요.

• 제한된 OceanBase 사용자 생성

• 적절한 권한 설정

• 데이터베이스 액세스 모니터링

• 보안 모범 사례

⚠️ 중요: 데이터베이스 액세스를 구성할 때는 항상 최소 권한 원칙을 따르세요.

특허

Apache 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기