读取: Metabase MCP 服务器

一个用于Metabase集成的综合模型上下文协议(MCP)服务器,为AI助手提供了对Metabase分析平台的充分访问.

QQ 快速启动

# Install and run with npx
export METABASE_URL=https://your-metabase-instance.com
export METABASE_API_KEY=your_metabase_api_key
npx @cognitionai/metabase-mcp-server

* 特性

🎯 81+ 可用工具 - 完成元数据库API覆盖

• 盘子管理 (23个工具) - 完整的CRUD操作,卡管理,公共共享,嵌入
• QQ卡/问题管理 (21个工具) - 查询执行,参数处理,枢轴查询,公共链接
• 数据库管理 (13个工具) - 连接管理, schema同步, 查询执行
• 表格管理 (16个工具) - 元数据操作,外地管理,数据操作
• +++ 附加工具 (9个工具) - 收藏,搜索,用户,活动跟踪,操场链接

* 安装

建议: 20.19.0+和npm 8.0.0+ 最佳相容性节点

方法1: NPX(建议)

npx @cognitionai/metabase-mcp-server

方法2:全球安装

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

方法 3: 嵌入器

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

QQ 配置

环境变量

API 密钥认证( 首选) :

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

用户名/ Password 认证( Fallback) :

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

可选参数

服务器支持命令行参数自定义工具加载 :

• --essential (默认):仅装入必要的工具
• --all: 装入所有80+可用工具
• --write: 只装入写入/修改工具
• --read: 只装入只读工具

# Using published package (recommended)
# Default behavior (essential tools only)
npx @cognitionai/metabase-mcp-server

# Load all tools
npx @cognitionai/metabase-mcp-server --all

# Load only write tools
npx @cognitionai/metabase-mcp-server --write

# Load only read-only tools
npx @cognitionai/metabase-mcp-server --read

# Using local development build
npm run build
node dist/server.js                    # Default (essential tools)
node dist/server.js --all             # All tools
node dist/server.js --write           # Write tools only
node dist/server.js --read            # Read-only tools only

综合实例

克劳德桌面

添加到您的 Claude 桌面配置( E)~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上:

使用已发布软件包 :

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

利用地方发展建设:

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

有自定义旗:

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

Windsurf IDE 风平浪静

添加到您的 Windsurf MCP 配置中(~/.windsurf/mcp_config.json:

使用已发布软件包 :

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

利用地方发展建设:

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

有自定义旗:

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

可用的工具

发展

设置

git clone https://github.com/CognitionAI/metabase-mcp-server.git
cd metabase-mcp-server
npm install

构建

npm run build

发展模式

npm run watch

调试

使用 MCP 检查器调试 :

npm run inspector

测试认证

API 密钥认证

1. 设定 METABASE_URL 财务报告和审定财务报表 METABASE_API_KEY
2. 启动服务器并在日志中验证“ Using Metabase API 密钥”
3. 测试 list_dashboards 工具

用户名/ 名词认证

1. 未设置 METABASE_API_KEY
2. 设定 METABASE_URL, (中文(简体) ), METABASE_USERNAME, (中文(简体) ), METABASE_PASSWORD
3. 启动服务器并验证日志中的“ 使用用户名/ 密码字 ”
4. 测试 list_dashboards 工具

* 解决问题

共同问题

认证错误 :

• 校验您的 Metabase URL 可以访问
• 在 Metabase 管理员设置中检查 API 密钥有效性
• 确保用户名/密码证书正确无误

连接问题 :

• 确认正在运行的 Metabase 实例
• 检查网络连接
• 使用 HTTPS 验证 SSL 证书

工具执行出错 :

• 检查您的用户/ API 密钥的 Metabase 权限
• 验证请求的资源存在
• 详细错误消息审查服务器日志

许可证

这个项目根据麻省理工学院许可证颁发——见 自由主义 详细文件.

捐款

欢迎捐款! 请来看我们 GitHub 仓库 改为:

• 报告错误
• 请求特性
• 提交拉动请求
• * 改进文件编制

发展指导方针

1. 叉子存储器
2. 创建特性分支
3. 用测试来改变
4. 确保所有测试通过
5. 提交拉动请求

++ 辅助

• 📚 文档
• 🐛 问题跟踪器

与"为世界而建"