元数据库服务器 MCP 服务器

用于 Metabase 集成的模型上下文协议服务器。

这是一个基于 TypeScript 的 MCP 服务器，实现了与 Metabase API 的集成。它允许 AI 助手与 Metabase 进行交互，并提供以下访问权限：

• 仪表板、问题/卡片和数据库作为资源

• 用于列出和执行 Metabase 查询的工具

• 能够查看和与 Metabase 数据交互

特征

资源

• 通过metabase:// URI 列出并访问 Metabase 资源

• 访问仪表板、卡片/问题和数据库

• 用于结构化数据访问的 JSON 内容类型

工具

• list_dashboards - 列出 Metabase 中的所有仪表板

• list_cards - 列出 Metabase 中的所有问题/卡片

• list_databases - 列出 Metabase 中的所有数据库

• execute_card Metabase 问题/卡片并获取结果

• get_dashboard_cards - 获取仪表板中的所有卡片

• execute_query ——对 Metabase 数据库执行 SQL 查询

Related MCP server: MariaDB Reader MCP Server

配置

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

# Required environment variables
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 一起使用，请添加服务器配置：

在 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 来访问浏览器中的调试工具。