imlewc/metabase-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

151 stars 39 forks 품질 62 트렌드 16

Repository Install

imlewc/metabase-server는 https://github.com/imlewc/metabase-server.에서 가져온 MCP 서버 후보입니다.

개요

imlewc/metabase-server는 https://github.com/imlewc/metabase-server.에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

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

이 서버는 Metabase API와의 통합을 구현한 TypeScript 기반 MCP 서버입니다. AI 비서가 Metabase와 상호작용할 수 있게 하여 다음 접근 권한을 제공합니다:

대시보드, 질문/카드, 데이터베이스 자원
메타베이스 쿼리를 나열하고 실행하는 도구
메타데이터 데이터를 보고 상호작용할 수 있는 기능

특징

자료

metabase:// URI를 통해 메타베이스 자원을 목록화하고 접근
대시보드, 카드/질문, 데이터베이스 접근
구조화된 데이터 접근을 위한 JSON 콘텐츠 유형

도구

list_dashboards - 메타베이스의 모든 대시보드 목록
list_cards - 메타베이스에 모든 질문/카드를 나열하세요
list_databases - 메타베이스 내 모든 데이터베이스 목록
execute_card - 메타베이스 질문/카드를 실행하고 결과를 얻습니다
get_dashboard_cards - 모든 카드를 대시보드에 넣으세요
execute_query - 메타베이스 데이터베이스에 대한 SQL 쿼리 실행

구성

서버를 실행하기 전에 인증을 위한 환경 변수를 설정해야 합니다. 서버는 두 가지 방법을 지원합니다:

API 키 (선호):

METABASE_URL: 메타베이스 인스턴스의 URL(예: https://your-metabase-instance.com).

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

metabase-server MCP Server

A Model Context Protocol server for Metabase integration.

This is a TypeScript-based MCP server that implements integration with Metabase API. It allows AI assistants to interact with Metabase, providing access to:

Dashboards, questions/cards, and databases as resources
Tools for listing and executing Metabase queries
Ability to view and interact with Metabase data

Features

Resources

List and access Metabase resources via metabase:// URIs
Access dashboards, cards/questions, and databases
JSON content type for structured data access

Tools

list_dashboards - List all dashboards in Metabase
list_cards - List all questions/cards in Metabase
list_databases - List all databases in Metabase
execute_card - Execute a Metabase question/card and get results
get_dashboard_cards - Get all cards in a dashboard
execute_query - Execute a SQL query against a Metabase database

Configuration

Before running the server, you need to set environment variables for authentication. The server supports two methods:

API Key (Preferred):
- METABASE_URL: The URL of your Metabase instance (e.g., https://your-metabase-instance.com).
- METABASE_API_KEY: Your Metabase API key.
Username/Password (Fallback):
- METABASE_URL: The URL of your Metabase instance.
- METABASE_USERNAME: Your Metabase username.
- METABASE_PASSWORD: Your Metabase password.

The server will first check for METABASE_API_KEY. If it’s set, API key authentication will be used. If METABASE_API_KEY is not set, the server will fall back to using METABASE_USERNAME and METABASE_PASSWORD. You must provide credentials for at least one of these methods.

Example setup:

Using API Key:

# Required environment variables
export METABASE_URL=https://your-metabase-instance.com
export METABASE_API_KEY=your_metabase_api_key

Or, using Username/Password:

# Required environment variables
export METABASE_URL=https://your-metabase-instance.com
export METABASE_USERNAME=your_username
export METABASE_PASSWORD=your_password

You can set these environment variables in your shell profile or use a .env file with a package like dotenv.

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

# Oneliner, suitable for CI environment
git clone https://github.com/imlewc/metabase-server.git && cd metabase-server && npm i && npm run build && npm link

To use with Claude Desktop, add the server config:

GitHub에서 전체 README 보기

설치

npx -y @imlewc/metabase-server

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "metabase-server": {
      "command": "metabase-server",
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        // Use API Key (preferred)
        "METABASE_API_KEY": "your_metabase_api_key"
        // Or Username/Password (if API Key is not set)
        // "METABASE_USERNAME": "your_username",
        // "METABASE_PASSWORD": "your_password"
      }
    }
  }
}