GoodData MCP服务器
⚠️ 已弃用：此存储库已迁移到 无堆栈mcp monorepo. 新套餐是stackless-gooddata在packages/gooddata/. 此回购仅供参考。请使用monorepo进行所有新开发。
______________________________________________________________________
  
让Claude Code直接访问您的GoodData分析平台。
A. 模型上下文协议（MCP） 服务器，使克劳德等人工智能助手能够与GoodData交互，允许对您的商业智能数据进行自然语言查询。还包括一个用于直接终端访问的独立CLI。
为什么使用这个？
- 人工智能驱动的分析：向Claude询问有关GoodData仪表板、指标和自然语言见解的问题
- 按设计只读：所有操作都是严格只读的，因此没有修改数据的风险
- 零配置：开箱即用Claude Code（只需添加您的凭据）
- 导出功能：将仪表板导出为PDF，将可视化导出为CSV/Excel
- 包含CLI：使用
gooddata直接从终端命令
特性
| 特性 | 描述 |
|---|---|
| 列出资源 | 工作区、仪表板、见解、指标、数据集、用户、组 |
| 查询数据 | 从任何洞察/可视化中检索数据 |
| 导出报告 | 将仪表板导出为PDF，将可视化导出为CSV/XLSX |
| 探索数据模型 | 获取用于文档的逻辑数据模型（LDM） |
| 用户管理 | 列出用户、组和组成员资格 |
快速开始
1.安装
# Clone the repository
git clone https://github.com/aalexmrt/gooddata-mcp-server.git
cd gooddata-mcp-server
# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install with MCP support
pip install -e ".[mcp]"2.配置
cp .env.example .env编辑 .env 使用您的GoodData凭据：
GOODDATA_HOST=https://your-org.cloud.gooddata.com
GOODDATA_TOKEN=your-api-token
GOODDATA_WORKSPACE=your-default-workspace-id获取API令牌：转到您的GoodData个人资料设置并创建个人访问令牌。
3.添加到克劳德代码
claude mcp add gooddata \
-s user \
-e GOODDATA_HOST="https://your-org.cloud.gooddata.com" \
-e GOODDATA_TOKEN="your-api-token" \
-e GOODDATA_WORKSPACE="your-workspace-id" \
-- /path/to/gooddata-mcp-server/.venv/bin/python -m gooddata_cli.mcp_server4.开始使用
在Claude Code中，您现在可以提出以下问题：
- “列出我的GoodData工作区中的所有仪表板”
- “有哪些可用的指标？”
- “向我展示收入概览洞察中的数据”
- “将销售仪表板导出为PDF”
______________________________________________________________________
MCP工具参考
| 工具 | 说明 |
|---|---|
list_workspaces | 列出所有可用工作区 |
list_insights | 在工作区中列出所有见解（可视化） |
list_dashboards | 列出工作区中的所有仪表板 |
list_metrics | 列出工作区中的所有指标 |
list_datasets | 列出工作区中的所有数据集 |
get_dashboard_insights | 获取仪表板中包含的所有见解 |
get_dashboard_filters | 在仪表板上配置所有过滤器 |
get_insight_metadata | 获取详细的元数据以获得洞察 |
get_insight_data | 从洞察中获取数据 |
get_logical_data_model | 获取工作区的逻辑数据模型 |
list_users | 列出组织中的所有用户 |
list_user_groups | 列出所有用户组 |
get_user_group_members | 获取特定组的成员 |
export_dashboard_pdf | 将仪表板导出为PDF |
export_visualization_csv | 将可视化导出到CSV |
export_visualization_xlsx | 将可视化导出到Excel |
MCP服务器管理
# Check server status
claude mcp list
# Remove the server
claude mcp remove gooddata______________________________________________________________________
CLI使用情况
该软件包还包括一个用于直接终端访问的独立CLI。
列出资源
# List all workspaces
gooddata list workspaces
# List insights in a workspace
gooddata list insights -w
# List dashboards
gooddata list dashboards -w
# List metrics
gooddata list metrics -w
# List datasets
gooddata list datasets -w
# JSON output
gooddata list workspaces --json查询数据
# Get data from a specific insight
gooddata insight -w 出口
# Export dashboard to PDF
gooddata export pdf -w
# Export visualization to CSV
gooddata export csv -w
# Export visualization to Excel
gooddata export xlsx -w
# Custom output path
gooddata export pdf -o ./my-report.pdf______________________________________________________________________
Python API
您还可以通过编程方式使用该包：
from gooddata_cli.query import list_workspaces, list_insights
from gooddata_cli.export import export_dashboard_pdf, export_visualization_tabular
# List workspaces
workspaces = list_workspaces()
# List insights
insights = list_insights(workspace_id="my_workspace")
# Export dashboard
path = export_dashboard_pdf("dashboard_id", workspace_id="my_workspace")______________________________________________________________________
项目结构
gooddata-mcp-server/
├── .env.example # Environment template
├── pyproject.toml # Package configuration
├── README.md # This file
├── LICENSE # MIT License
├── CONTRIBUTING.md # Contribution guidelines
└── src/gooddata_cli/
├── __init__.py # Package exports
├── sdk.py # SDK initialization
├── query.py # Query operations
├── export.py # Export operations
├── cli.py # CLI entry point
└── mcp_server.py # MCP server for Claude Code______________________________________________________________________
安全说明
所有操作都是只读的。 此MCP服务器无法在GoodData中创建、更新或删除任何数据。操作仅限于：
- 列出资源（工作区、见解、仪表板、指标、数据集、用户、组）
- 查询现有数据
- 将报告导出到本地文件
______________________________________________________________________
依赖项
- gooddata sdk -GoodData官方Python SDK
- gooddata熊猫 -Pandas与GoodData的集成
- 主控程序 -模型上下文协议SDK
- 点击 -CLI框架
- 富有的 -终端格式化
- python dotenv -环境变量加载
______________________________________________________________________
贡献
欢迎投稿！请看 贡献.md 作为指导方针。
______________________________________________________________________
许可证
MIT许可证-请参阅 许可证 了解详情。
______________________________________________________________________
相关项目
- GoodData Python SDK -官方GoodData SDK
- 模型上下文协议 -MCP规范
- 克劳德代码 -AI编码助手