MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-12 20:42
태그:
#MCP #데이터베이스 #클라우드 #관리형 서비스 #써드파티

링크된 문서

역링크

Aiven MCP 서버

Aiven MCP 서버

Aiven MCP 서버는 Aiven에서 개발한 Model Context Protocol(MCP) 서버로, PostgreSQL®, Apache Kafka®, ClickHouse®, OpenSearch® 등 Aiven에서 제공하는 다양한 관리형 데이터베이스 및 메시징 서비스에 접근할 수 있는 기능을 제공합니다.

주요 기능

  • 다양한 Aiven 서비스 지원: PostgreSQL, Kafka, ClickHouse, OpenSearch 등 지원
  • 프로젝트 관리: Aiven 프로젝트 탐색 및 서비스 설정 변경
  • 서비스 모니터링: 서비스 상태, 메트릭, 로그 확인
  • 데이터베이스 상호작용: 데이터베이스 쿼리, 스키마 관리, 데이터 조작
  • 보안 통합: 안전한 인증 및 접근 제어

지원되는 Aiven 서비스

Aiven MCP 서버는 다음과 같은 Aiven 서비스를 지원합니다:

  1. PostgreSQL:
  2. 데이터베이스 쿼리 실행
  3. 스키마 탐색 및 관리

  4. 성능 모니터링 및 최적화

  5. Apache Kafka:

  6. 토픽 생성 및 관리
  7. 메시지 생산 및 소비

  8. Kafka Connect 커넥터 관리

  9. ClickHouse:

  10. 대규모 분석 쿼리 실행
  11. 데이터 마트 및 웨어하우스 관리

  12. 실시간 데이터 분석

  13. OpenSearch:

  14. 인덱스 관리
  15. 검색 및 쿼리 실행
  16. 분석 및 시각화

제공 도구

Aiven MCP 서버는 다음과 같은 도구를 제공합니다:

프로젝트 관리 도구

  • list_projects: 사용자의 모든 Aiven 프로젝트 조회
  • get_project_details: 특정 프로젝트의 상세 정보 조회
  • list_project_services: 프로젝트 내 모든 서비스 목록 조회

서비스 관리 도구

  • get_service_details: 특정 서비스의 상세 정보 조회
  • create_service: 새 서비스 생성
  • update_service: 기존 서비스 구성 업데이트
  • delete_service: 서비스 삭제

데이터베이스 도구 (PostgreSQL)

  • pg_execute_query: PostgreSQL 데이터베이스에서 쿼리 실행
  • pg_list_databases: PostgreSQL 서비스의 모든 데이터베이스 조회
  • pg_list_tables: 데이터베이스 내 모든 테이블 조회

Kafka 도구

  • kafka_list_topics: Kafka 서비스의 모든 토픽 조회
  • kafka_create_topic: 새 Kafka 토픽 생성
  • kafka_produce_message: Kafka 토픽에 메시지 생산
  • kafka_consume_messages: Kafka 토픽에서 메시지 소비

ClickHouse 도구

  • ch_execute_query: ClickHouse 데이터베이스에서 쿼리 실행
  • ch_list_databases: ClickHouse 서비스의 모든 데이터베이스 조회
  • ch_list_tables: 데이터베이스 내 모든 테이블 조회

OpenSearch 도구

  • os_search: OpenSearch 인덱스에서 검색 실행
  • os_list_indices: OpenSearch 서비스의 모든 인덱스 조회
  • os_create_index: 새 OpenSearch 인덱스 생성

설정 방법

Claude Desktop에 추가하기

Claude Desktop의 claude_desktop_config.json 파일에 다음 JSON 블록을 추가합니다:

{
  "mcpServers": {
    "aiven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@aiven-open/mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "your-aiven-api-token",
        "AIVEN_API_URL": "https://api.aiven.io",
        "AIVEN_PROJECT": "your-default-project-name"
      }
    }
  }
}

Aiven 인증 설정

Aiven MCP 서버는 다음과 같은 인증 정보가 필요합니다:

  1. AIVEN_TOKEN: Aiven 계정의 API 토큰
  2. Aiven 콘솔의 사용자 설정에서 생성 가능

  3. 필요한 권한: 읽기 또는 관리자(쓰기 작업이 필요한 경우)

  4. AIVEN_API_URL (선택 사항):

  5. 기본값: https://api.aiven.io

  6. 특정 리전이나 엔드포인트가 필요한 경우 변경

  7. AIVEN_PROJECT (선택 사항):

  8. 기본 프로젝트 이름
  9. 프로젝트 이름을 명시하지 않은 요청에 사용됨

사용 사례

  • 데이터베이스 관리 자동화: Aiven 데이터베이스 서비스의 배포 및 관리 자동화
  • 데이터 파이프라인 구축: Kafka와 데이터베이스를 연결하는 데이터 파이프라인 관리
  • 모니터링 및 알림: 서비스 상태 및 성능 모니터링, 이상 감지
  • 멀티 서비스 데이터 분석: 여러 Aiven 서비스 간 데이터 분석 및 마이그레이션
  • 인프라 최적화: 사용 패턴에 따른 서비스 크기 조정 및 성능 최적화

사용 예시

PostgreSQL 쿼리 실행:

SELECT * FROM users WHERE last_login > NOW() - INTERVAL '7 days';

Kafka 토픽 생성:

Topic Name: user_events
Partitions: 3
Replication Factor: 2
Configs: { "retention.ms": 604800000 }

ClickHouse 대용량 데이터 분석:

SELECT date, count() as events_count
FROM events
WHERE type = 'purchase'
GROUP BY date
ORDER BY date DESC
LIMIT 30;

보안 고려사항

  • Aiven API 토큰은 기밀 정보로 취급하고 안전하게 관리해야 합니다.
  • 필요한 최소한의 권한만 가진 토큰을 사용하세요.
  • 데이터베이스 쿼리는 읽기 전용으로 제한하는 것이 권장됩니다.
  • 민감한 데이터에 접근하는 경우 추가적인 인증 및 승인 과정을 구현하세요.

라이센스

이 서버는 Apache 2.0 라이센스에 따라 라이센스가 부여됩니다.

관련 링크