Metabase MCP 服务器

A 类 Metabase 的模型上下文协议服务器 它让AI助手可以完全进入你的分析平台——仪表板,卡片,数据库,表格,收藏品等等.

开发和维护 简单云 ——云原性,AI驱动,和数据基础设施解决方案.

快速启动

export METABASE_URL=https://your-metabase-instance.com
export METABASE_API_KEY=your_metabase_api_key
npx @easecloudio/mcp-metabase-server

96 可用工具

支持的元库版本

• Metabase v.046.x及以上(建议:v.048.x或后期)
• Metabase Cloud( 完全支持)
• 自办案件(Docker、JAR或云层部署)

安装

npx( 建议)

npx @easecloudio/mcp-metabase-server

全局安装

npm install -g @easecloudio/mcp-metabase-server
mcp-metabase-server

夹克

docker build -t mcp-metabase-server .
docker run -it --rm \
  -e METABASE_URL=https://your-metabase-instance.com \
  -e METABASE_API_KEY=your_metabase_api_key \
  mcp-metabase-server

配置

认证

API 密钥( 首选 ) :

METABASE_URL=https://your-metabase-instance.com
METABASE_API_KEY=your_metabase_api_key

用户名/ 密码( 回落) :

METABASE_URL=https://your-metabase-instance.com
METABASE_USERNAME=your_username
METABASE_PASSWORD=your_password

复制 .env.example 改为 .env 并填写您的值.

工具过滤( TOOL MODE)

设定 TOOL_MODE 控制哪些工具暴露于AI. 用于限制地表面积或防止意外写作.

TOOL_MODE=essential  # smallest surface area
TOOL_MODE=read       # read-only
TOOL_MODE=all        # everything (default)

克劳德桌面集成

马可斯: ~/Library/Application Support/Claude/claude_desktop_config.json 窗口 : %APPDATA%/Claude/claude_desktop_config.json

使用 npx :

{
  "mcpServers": {
    "metabase": {
      "command": "npx",
      "args": ["@easecloudio/mcp-metabase-server"],
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        "METABASE_API_KEY": "your_metabase_api_key"
      }
    }
  }
}

通过工具过滤 :

{
  "mcpServers": {
    "metabase": {
      "command": "npx",
      "args": ["@easecloudio/mcp-metabase-server"],
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        "METABASE_API_KEY": "your_metabase_api_key",
        "TOOL_MODE": "essential"
      }
    }
  }
}

使用本地建筑:

{
  "mcpServers": {
    "metabase": {
      "command": "node",
      "args": ["/path/to/metabase-server/dist/index.js"],
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        "METABASE_API_KEY": "your_metabase_api_key"
      }
    }
  }
}

用户名/ 密码倒置 :

{
  "mcpServers": {
    "metabase": {
      "command": "npx",
      "args": ["@easecloudio/mcp-metabase-server"],
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        "METABASE_USERNAME": "your_username",
        "METABASE_PASSWORD": "your_password"
      }
    }
  }
}

可用工具

MCP 资源

直接通过 metabase:// URIs : (英语)

发展

npm install
npm run build       # compile TypeScript → dist/
npm run watch       # incremental rebuild
npm run dev         # build + start
npm run inspector   # launch MCP Inspector for debugging

调试

MCP服务器通过stdio通信,这使得直接调试变得尴尬. 使用 MCP 检查员数字 :

npm run inspector

检查员提供浏览器UI,用于发送工具呼叫并检查回复.

关于 EaseCloud

EaseCloud是一家云咨询和解决方案公司,专门从事:

• 云内应用开发
• AI和自动化集成
• D. 发展业务和基础设施管理
• 数据分析和BI平台咨询

我们建立这个项目是为了促进开源的MCP生态系统,同时展示我们在集成、自动化和云解决方案方面的专长.

如果你的团队在规模上采用Metabase 或者想将AI与你的BI堆集成在一起, 联系 我们为企业提供咨询、定制和管理下的支助.

📧 支持@ accloud.io 🌐 eleascloud.io (英语)

错误报告与问题

找到错误还是有特性请求 ?

🐛 创建 GitHub 问题

请包括:

• 元库版本
• MCP 服务器版本
• 复制步骤
• 预期与实际行为
• 任何错误消息或日志

捐款

欢迎捐款。 访问 GitHub 仓库 提交问题或撤回请求.

许可证

麻省理工学院——见 自由主义 详细情况.