metabase-server P

元数据库MCP服务器

](https://www.npmjs.com/package/@easecloudio/mcp-metabase-server)   ](https://github.com/easecloudio/mcp-metabase-server)

A. 元数据库的模型上下文协议（MCP）服务器 这使AI助手可以完全访问您的分析平台——仪表板、卡片、数据库、表格、集合等。

由开发和维护 EaseCloud --云原生、人工智能驱动和数据基础设施解决方案。

快速开始

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

96种可用工具

支持的元数据库版本

• 元数据库v0.46.x及以上版本（推荐：v0.48.x或更高版本）
• 元数据库云（完全支持）
• 自托管实例（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)

Claude桌面集成

MacOS： ~/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"
      }
    }
  }
}

可用工具

Dashboard Management (27 tools)

核心CRUD

卡片布局

公共共享与嵌入

修订、审核和发现

Card / Question Management (21 tools)

核心CRUD

执行和导出

参数

元数据和发现

公共共享与嵌入

Database Management (16 tools)

核心CRUD

询问

架构与同步

诊断

Table Management (17 tools)

元数据

卡片虚拟桌

管理

CSV上传（元数据库管理的表）

Collections, Users & Search (13 tools)

集合

用户

权限

搜索

Schema Cache — SQL to MBQL (2 tools)

这些工具使人工智能能够将原生SQL问题转换为交互式MBQL问题。元数据库没有用于此转换的REST API-它需要字段ID，这些工具将这些字段ID缓存在本地。

它是如何工作的：

1. get_card --提取SQL和 database_id
2. get_schema_cache --获取MBQL引用的表+字段ID，如 ["field", 42, null]
3. AI翻译SQL→ MBQL使用缓存的字段ID
4. create_card --保存新的交互式问题

缓存存储在 ~/.easecloud/metabase-mcp/cache/{url-hash}/ 具有24小时TTL和每个Metabase实例的作用域。

MCP资源

直接通过以下方式访问元数据库实体 metabase:// URI：

发展

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

Inspector提供了一个浏览器UI，用于发送工具调用和检查响应。

关于易云

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

• 云原生应用开发
• 人工智能和自动化集成
• DevOps和基础设施管理
• 数据分析和BI平台咨询

我们构建这个项目是为了为开源MCP生态系统做出贡献，同时展示我们在集成、自动化和云解决方案方面的专业知识。

如果您的团队正在大规模采用Metabase或希望将AI与BI堆栈集成， 联系 --我们为企业提供咨询、定制和管理支持。

📧 support@easecloud.io 🌐 easecloud.io

Bug报告和问题

发现错误或有功能请求？

🐛

请包括：

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

贡献

欢迎捐款。访问 提交问题或拉取请求。

许可证

麻省理工学院——见 许可证 了解详情。