메타베이스 서버 MCP 서버

메타베이스 통합을 위한 모델 컨텍스트 프로토콜 서버.

Metabase API와의 통합을 구현하는 TypeScript 기반 MCP 서버입니다. AI 어시스턴트가 Metabase와 상호 작용하여 다음 항목에 액세스할 수 있도록 지원합니다.

대시보드, 질문/카드 및 데이터베이스를 리소스로 사용
메타베이스 쿼리를 나열하고 실행하기 위한 도구
메타베이스 데이터를 보고 상호 작용하는 기능

특징

자원

metabase:// URI를 통해 Metabase 리소스를 나열하고 액세스합니다.
대시보드, 카드/질문 및 데이터베이스에 액세스하세요
구조화된 데이터 액세스를 위한 JSON 콘텐츠 유형

도구

list_dashboards - Metabase의 모든 대시보드 나열
list_cards - Metabase의 모든 질문/카드 나열
list_databases - Metabase의 모든 데이터베이스 나열
execute_card - Metabase 질문/카드를 실행하고 결과를 얻습니다.
get_dashboard_cards - 대시보드의 모든 카드 가져오기
execute_query - Metabase 데이터베이스에 대해 SQL 쿼리를 실행합니다.

구성

서버를 실행하기 전에 다음 환경 변수를 설정해야 합니다.

지엑스피1

쉘 프로필에서 이러한 환경 변수를 설정하거나 dotenv 와 같은 패키지와 함께 .env 파일을 사용할 수 있습니다.

개발

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "metabase-server": {
      "command": "/path/to/metabase-server/build/index.js",
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        "METABASE_USERNAME": "your_username",
        "METABASE_PASSWORD": "your_password"
      }
    }
  }
}

참고: 원한다면 구성 파일 대신 시스템에서 이러한 환경 변수를 설정할 수도 있습니다.

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 metabase-server를 자동으로 설치하려면:

npx -y @smithery/cli install @imlewc/metabase-server --client claude

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

Metabase Server MCP

Integrations

메타베이스 서버 MCP 서버

특징

자원

도구

구성

개발

설치

Smithery를 통해 설치

디버깅