lightdash-mcp-服务器
访问Lightdash的MCP(模型上下文协议)服务器。
该服务器提供与 MCP 兼容的 Lightdash API 访问,允许 AI 助手通过标准化界面与您的 Lightdash 数据进行交互。
特征
可用工具:
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 服务器:
npx -y @smithery/cli install lightdash-mcp-server --client claude
手动安装
npm install lightdash-mcp-server
配置
使用您的 Lightdash API 凭证创建一个.env
文件:
LIGHTDASH_API_KEY=your_api_key
LIGHTDASH_API_URL=https://app.lightdash.cloud # or your custom Lightdash instance URL
用法
- 启动 MCP 服务器。
直接地:
或者,使用节点运行已安装的模块。
- 编辑您的 MCP 配置 json:
...
"lightdash": {
"command": "npx",
"args": [
"-y",
"lightdash-mcp-server"
],
"env": {
"LIGHTDASH_API_KEY": "<your PAT>",
"LIGHTDASH_API_URL": "https://<your base url>"
}
},
...
发展
可用脚本
npm run dev
- 使用热重载以开发模式启动服务器npm run build
构建生产项目npm run start
启动生产服务器npm run lint
- 运行 linting 检查(ESLint 和 Prettier)npm run fix
- 自动修复 linting 问题npm run examples
- 运行示例脚本
贡献
- 分叉存储库
- 创建你的功能分支
- 运行测试和 lint:
npm run lint
- 提交你的更改
- 推送到分支
- 创建拉取请求