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 助手消费
• 全面日志记录：详细日志记录，便于调试和监控
• 错误处理：功能强大的错误处理，带清晰的错误消息

🛠️ 可用工具

该服务器为 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

📦 安装指南

要安装 Metabase MCP 服务器，请按照以下步骤操作：

克隆仓库

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

安装依赖项

npm install

运行开发服务器

npm run dev

🐳 Docker 支持

要使用 Docker 部署 Metabase MCP 服务器，请执行以下命令：

构建 Docker 映像

docker build -t metabase-mcp .

运行容器

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

⚠️ 安全注意事项

⚠️ 重要提示

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

👥 贡献

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