Metabase MCP 服务器

一个将 AI 助手与 Metabase 分析平台集成的模型上下文协议 (MCP) 服务器。

概述

此 MCP 服务器提供了与 Metabase API 的集成，使具备 MCP 功能的 LLM 能够直接与您的分析数据进行交互，该服务器充当了您的分析平台与对话式 AI 之间的桥梁。

主要功能

• 资源访问：通过直观的 metabase:// URI 导航 Metabase 资源

• 两种身份验证方法：支持基于会话和 API 密钥的身份验证

• 结构化数据访问：JSON 格式的响应，便于 AI 助手使用

• 全面日志记录：详细的日志记录，便于调试和监控

• 错误处理：稳健的错误处理机制，提供清晰的错误消息

Related MCP server: Metabase MCP Server

可用工具

该服务器为 AI 助手提供了以下工具：

数据访问工具

• list_dashboards：检索 Metabase 实例中所有可用的仪表板

• list_cards：获取 Metabase 中所有已保存的问题/卡片

• list_databases：查看所有已连接的数据库源

• list_collections：列出 Metabase 中的所有集合

• list_tables：列出特定数据库中的所有表

• get_table_fields：获取特定表中的所有字段/列

执行工具

• execute_card：运行已保存的问题并检索结果（支持可选参数）

• execute_query：针对任何已连接的数据库执行自定义 SQL 查询

仪表板管理

• get_dashboard_cards：从特定仪表板中提取所有卡片

• create_dashboard：使用指定的名称和参数创建新仪表板

• update_dashboard：更新现有仪表板的名称、描述或参数

• delete_dashboard：删除仪表板

• add_card_to_dashboard：通过位置规范和可选的标签页分配，在仪表板中添加或更新卡片

卡片/问题管理

• create_card：使用 SQL 查询创建新问题/卡片

• update_card_visualization：更新卡片的可视化设置

集合管理

• create_collection：创建新集合以组织仪表板和问题

配置

该服务器支持两种身份验证方法：

选项 1：用户名和密码身份验证

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_USER_EMAIL=your_email@example.com
METABASE_PASSWORD=your_password

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

选项 2：API 密钥身份验证（生产环境推荐）

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_API_KEY=your_api_key

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

您可以直接设置这些环境变量，或使用 dotenv 通过 .env 文件进行设置。

使用 Smithery 部署

要将此 MCP 服务器与 Claude 或其他 AI 助手一起使用，请 fork 此存储库并使用 Smithery 进行部署：

部署步骤：

1. 将此存储库 fork 到您的 GitHub 帐户

2. 前往 Smithery 并使用您的 GitHub 帐户连接

3. 通过 Smithery 的界面部署 fork 后的存储库

Claude Desktop 集成

配置您的 Claude Desktop 以使用 Smithery 托管的版本：

MacOS：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

Windows：编辑 %APPDATA%/Claude/claude_desktop_config.json

API 密钥身份验证：

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"your_api_key\",\"metabasePassword\":\"\",\"metabaseUserEmail\":\"\"}"
      ]
    }
  }
}

用户名和密码身份验证：

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"\",\"metabasePassword\":\"your_password\",\"metabaseUserEmail\":\"your_email@example.com\"}"
      ]
    }
  }
}

安全注意事项

• 建议在生产环境中使用 API 密钥身份验证

• 请妥善保管您的 API 密钥和凭据

• 考虑使用环境变量，而不是硬编码凭据

• 采取适当的网络安全措施以限制对 Metabase 实例的访问

贡献

欢迎贡献！请随时提交 Pull Request。