Metabase MCP

🚀 Metabase MCP 服务器

Metabase MCP 服务器是一个模型上下文协议（Model Context Protocol）服务器，它能将 AI 助手与 Metabase 分析平台集成在一起，让 AI 助手可以直接与分析数据交互。

🚀 快速开始

Metabase MCP 服务器提供与 Metabase API 的集成，让具备 MCP 功能的大语言模型（LLM）能够直接与分析数据进行交互，在分析平台和对话式 AI 之间搭建起沟通的桥梁。

✨ 主要特性

• 资源访问：通过直观的 metabase:// URI 导航 Metabase 资源。
• 两种身份验证方法：支持基于会话和 API 密钥的身份验证。
• 结构化数据访问：以 JSON 格式返回数据，方便 AI 助手使用。
• 全面日志记录：详细记录日志，便于调试和监控。
• 错误处理：具备强大的错误处理能力，会给出清晰的错误消息。

📦 安装指南

克隆仓库

git clone git@github.com:hyeongjun-dev/metabase-mcp.git
cd metabase-mcp

安装依赖项

npm install

运行开发服务器

npm run dev

Docker 部署

构建 Docker 映像

docker build -t metabase-mcp .

运行容器

docker run -e METABASE_URL=https://your-metabase.com -e METABASE_API_KEY=your_api_key metabase-mcp

💻 使用示例

可用工具

该服务器为 AI 助手公开了以下工具：

数据访问工具

• list_dashboards：检索 Metabase 实例中的所有可用仪表板。
• list_cards：获取 Metabase 中的所有保存的问题/卡片。
• list_databases：查看所有连接的数据库源。
• list_collections：列出 Metabase 中的所有集合。
• list_table_columns：列出指定表的列。

仪表板操作工具

• execute_card：执行指定的卡片并返回结果。
• get_card_result：获取指定卡片的最新结果。
• get_result_preview：获取指定结果的预览。
• download_result：下载指定结果的文件。
• watch_cards：订阅对多个卡片的关注，以在发生变化时接收更新。

集合操作工具

• list_collection_objects：列出集合中的所有对象（仪表板、卡片等）。
• get_collection_object：获取集合中的特定对象。

📚 详细文档

配置

要配置 Metabase MCP 服务器，请设置以下环境变量：

基于 API 密钥的身份验证

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

基于用户名和密码的身份验证

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

安全注意事项

• 建议在生产环境中使用 API 密钥身份验证。
• 保持您的 API 密钥和凭据安全。
• 考虑使用 Docker 密钥或环境变量而不是硬编码凭据。
• 应用适当网络安全措施以限制对 Metabase 实例的访问。

📄 许可证

文档中未提及许可证相关信息。

🤝 贡献

欢迎贡献！请随时提交拉取请求。