Metabase MCP Server

🚀 metabase-server MCP 服务端

一个用于与 Metabase 集成的模型上下文协议（Model Context Protocol）服务器。该服务端基于 TypeScript 实现，支持与 Metabase API 集成，能让 AI 助手访问 Metabase 中的仪表板、问题/卡片和数据库资源，还提供工具列出并执行 Metabase 查询，以及查看和交互 Metabase 数据。

🚀 快速开始

metabase-server MCP 服务端是一个强大的工具，用于与 Metabase 集成，为 AI 助手提供对 Metabase 资源的访问能力。以下是使用该服务端的基本步骤：

1. 按照配置部分的说明设置必要的环境变量。
2. 安装依赖并构建服务端。
3. 根据需求选择合适的安装方式，如与 Claude Desktop 集成或通过 Smithery 安装。

✨ 主要特性

资源

• 通过 metabase:// URI 访问 Metabase 资源。
• 可获取仪表板、卡片/问题和数据库资源。
• 支持 JSON 内容类型，方便获取结构化数据访问。

工具

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

📦 安装指南

配置环境变量

在运行服务端之前，需要设置以下环境变量：

# 必须的环境变量
export METABASE_URL=https://your-metabase-instance.com
export METABASE_USERNAME=your_username
export METABASE_PASSWORD=your_password

你可以通过 shell 配置文件或使用 dotenv 包在 .env 文件中设置这些环境变量。

开发环境安装

安装依赖

npm install

构建服务端

npm run build

带有自动重建功能的开发

npm run watch

与 Claude Desktop 集成安装

要与 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 自动安装 metabase-server：

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

调试

由于 MCP 服务器通过标准输入/输出进行通信，调试可能会比较困难。我们推荐使用 MCP Inspector，它作为一个包脚本可用：

npm run inspector

Inspector 将提供一个访问浏览器调试工具的 URL。