lightdash-mcp-server

一个访问 Lightdash 的 MCP(模型上下文协议) 服务器。

该服务器提供与 MCP 兼容的 Lightdash API 访问，允许 AI 助手通过标准化接口与您的 Lightdash 数据进行交互。

<a href="https://glama.ai/mcp/servers/e1gbb6sflq"> <img width="380" height="200" src="https://glama.ai/mcp/servers/e1gbb6sflq/badge" alt="Lightdash Server MCP server" /> </a>

特性

可用工具：

• list_projects - 列出 Lightdash 组织中的所有项目
• get_project - 获取特定项目的详细信息
• list_spaces - 列出项目中的所有空间
• list_charts - 列出项目中的所有图表
• list_dashboards - 列出项目中的所有仪表盘
• get_custom_metrics - 获取项目的自定义指标
• get_catalog - 获取项目的目录
• get_metrics_catalog - 获取项目的指标目录
• get_charts_as_code - 获取项目的图表代码
• get_dashboards_as_code - 获取项目的仪表盘代码

快速开始

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Lightdash MCP Server：

npx -y @smithery/cli install lightdash-mcp-server --client claude

手动安装

npm install lightdash-mcp-server

配置

• LIGHTDASH_API_KEY: 您的 Lightdash PAT
• LIGHTDASH_API_URL: API 基础 URL

用法

1. 启动 MCP 服务器。

直接启动：

npx lightdash-mcp-server

或者，使用 node 运行已安装的模块。

2. 编辑您的 MCP 配置文件 json：

...
    "lightdash": {
      "command": "npx",
      "args": [
        "-y",
        "lightdash-mcp-server"
      ],
      "env": {
        "LIGHTDASH_API_KEY": "<您的 PAT>",
        "LIGHTDASH_API_URL": "https://<您的基础 url>"
      }
    },
...

开发

可用脚本

• npm run dev - 以热重载的开发模式启动服务器
• npm run build - 构建用于生产环境的项目
• npm run start - 启动生产服务器
• npm run lint - 运行 linting 检查（ESLint 和 Prettier）
• npm run fix - 自动修复 linting 问题
• npm run examples - 运行示例脚本

贡献

1. Fork 仓库
2. 创建您的功能分支
3. 运行测试和 linting: npm run lint
4. 提交您的更改
5. 推送到分支
6. 创建 Pull Request