metabase-server MCP Server

metabase-server MCP Server

site icon
2025.03.14 2
JavaScript数据查询报表生成数据分析数据库
berrystreet-metabase-mcp 是一个基于 TypeScript 的 MCP 服务器,用于与 Metabase API 集成。它允许 AI 助手与 Metabase 交互,提供对仪表板、问题/卡片和数据库等资源的访问,以及执行 Metabase 查询的工具。
View on GitHub

Overview

基本能力

产品定位

berrystreet-metabase-mcp 是一个用于与 Metabase 集成的 MCP 服务器,旨在通过 AI 助手提供对 Metabase 数据的访问和操作能力。

核心功能

  • 资源访问:通过 metabase:// URI 列出和访问 Metabase 资源,包括仪表板、卡片/问题和数据库。
  • 工具集:提供多种工具用于与 Metabase 交互,包括列出仪表板、卡片、数据库,执行卡片查询和 SQL 查询等。

适用场景

  • 需要 AI 助手访问和操作 Metabase 数据的场景。
  • 自动化数据查询和报表生成。
  • 数据分析和可视化集成。

工具列表

  • list_dashboards:列出 Metabase 中的所有仪表板。
  • list_cards:列出 Metabase 中的所有问题/卡片。
  • list_databases:列出 Metabase 中的所有数据库。
  • execute_card:执行 Metabase 问题/卡片并获取结果。
  • get_dashboard_cards:获取仪表板中的所有卡片。
  • execute_query:对 Metabase 数据库执行 SQL 查询。

常见问题解答

  • 如何配置环境变量?:需要设置 METABASE_URLMETABASE_USERNAMEMETABASE_PASSWORD 环境变量。
  • 如何调试?:推荐使用 MCP Inspector 进行调试,可通过 npm run inspector 启动。

使用教程

使用依赖

在运行服务器之前,需要设置以下环境变量:

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

安装教程

  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发模式(自动重建):
npm run watch

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

许可证

None