Metabase MCP 서버

AI 어시스턴트와 Metabase 분석 플랫폼을 통합하는 Model Context Protocol 서버입니다.

개요

이 MCP 서버는 Metabase API와의 통합을 제공하여, MCP 기능을 갖춘 LLM이 분석 데이터와 직접 상호작용할 수 있도록 합니다. 이 서버는 분석 플랫폼과 대화형 AI 사이의 가교 역할을 합니다.

주요 기능

• 리소스 액세스: 직관적인 metabase:// URI를 통해 Metabase 리소스 탐색

• 두 가지 인증 방식: 세션 기반 및 API 키 인증 모두 지원

• 구조화된 데이터 액세스: AI 어시스턴트가 쉽게 사용할 수 있도록 JSON 형식으로 응답

• 포괄적인 로깅: 디버깅 및 모니터링을 위한 상세 로깅 제공

• 오류 처리: 명확한 오류 메시지를 통한 강력한 오류 처리

Related MCP server: Metabase MCP Server

사용 가능한 도구

이 서버는 AI 어시스턴트를 위해 다음과 같은 도구를 제공합니다:

데이터 액세스 도구

• list_dashboards: Metabase 인스턴스에서 사용 가능한 모든 대시보드 검색

• list_cards: Metabase에 저장된 모든 질문/카드 가져오기

• list_databases: 연결된 모든 데이터베이스 소스 보기

• list_collections: Metabase의 모든 컬렉션 나열

• list_tables: 특정 데이터베이스의 모든 테이블 나열

• get_table_fields: 특정 테이블의 모든 필드/열 가져오기

실행 도구

• execute_card: 저장된 질문을 실행하고 선택적 매개변수와 함께 결과 검색

• execute_query: 연결된 데이터베이스에 대해 사용자 지정 SQL 쿼리 실행

대시보드 관리

• get_dashboard_cards: 특정 대시보드에서 모든 카드 추출

• create_dashboard: 지정된 이름과 매개변수로 새 대시보드 생성

• update_dashboard: 기존 대시보드의 이름, 설명 또는 매개변수 업데이트

• delete_dashboard: 대시보드 삭제

• add_card_to_dashboard: 위치 지정 및 선택적 탭 할당을 통해 대시보드에 카드 추가 또는 업데이트

카드/질문 관리

• create_card: SQL 쿼리를 사용하여 새 질문/카드 생성

• update_card_visualization: 카드의 시각화 설정 업데이트

컬렉션 관리

• create_collection: 대시보드와 질문을 정리하기 위한 새 컬렉션 생성

구성

이 서버는 두 가지 인증 방식을 지원합니다:

옵션 1: 사용자 이름 및 비밀번호 인증

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_USER_EMAIL=your_email@example.com
METABASE_PASSWORD=your_password

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

옵션 2: API 키 인증 (운영 환경 권장)

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_API_KEY=your_api_key

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

이러한 환경 변수를 직접 설정하거나 dotenv와 함께 .env 파일을 사용할 수 있습니다.

Smithery를 이용한 배포

Claude 또는 다른 AI 어시스턴트와 이 MCP 서버를 사용하려면, 이 저장소를 포크하고 Smithery를 사용하여 배포하세요:

배포 단계:

1. 이 저장소를 GitHub 계정으로 포크합니다.

2. Smithery로 이동하여 GitHub 계정으로 연결합니다.

3. Smithery 인터페이스를 통해 포크된 저장소를 배포합니다.

Claude Desktop 통합

Smithery에서 호스팅되는 버전을 사용하도록 Claude Desktop을 구성하세요:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 편집

Windows: %APPDATA%/Claude/claude_desktop_config.json 편집

API 키 인증:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"your_api_key\",\"metabasePassword\":\"\",\"metabaseUserEmail\":\"\"}"
      ]
    }
  }
}

사용자 이름 및 비밀번호 인증:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"\",\"metabasePassword\":\"your_password\",\"metabaseUserEmail\":\"your_email@example.com\"}"
      ]
    }
  }
}

보안 고려 사항

• 운영 환경에서는 API 키 인증 사용을 권장합니다.

• API 키와 자격 증명을 안전하게 보관하세요.

• 자격 증명을 하드코딩하는 대신 환경 변수 사용을 고려하세요.

• Metabase 인스턴스에 대한 액세스를 제한하기 위해 적절한 네트워크 보안 조치를 적용하세요.

기여

기여를 환영합니다! 자유롭게 Pull Request를 제출해 주세요.