metabase-server MCP Server

metabase-server MCP Server

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

Overview

基本能力

产品定位

metabase-server 是一个用于 Metabase 集成的 MCP 服务器,旨在通过 AI 助手与 Metabase 进行交互,提供数据访问和查询功能。

核心功能

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

适用场景

  • AI 助手需要与 Metabase 数据进行交互的场景。
  • 需要自动化访问和查询 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 启动。

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

  1. 克隆项目并安装依赖: bash npm install
  2. 构建服务器: bash npm run build
  3. 配置环境变量: bash export METABASE_URL=https://your-metabase-instance.com export METABASE_USERNAME=your_username export METABASE_PASSWORD=your_password
  4. 使用 Smithery 自动安装: bash npx -y @smithery/cli install @imlewc/metabase-server --client claude

调试方式

  1. 启动 MCP Inspector: bash npm run inspector
  2. 访问浏览器提供的 URL 进行调试。

许可证

None