使用说明

本项目是一个基于 Model Context Protocol (MCP) 实现的服务器，旨在连接 GoodData 数据分析平台，并将其功能（如可视化搜索、导出、报告调度）暴露给支持 MCP 的大型语言模型（LLM）客户端。

项目简介

GoodData MCP 服务器作为LLM客户端与GoodData平台之间的桥梁，允许LLM通过标准化的MCP工具接口访问GoodData的数据和功能，从而增强LLM在商业智能和数据分析领域的应用能力。

主要功能点

可视化搜索: 允许LLM或用户通过自然语言查询，在指定的GoodData工作空间中搜索相关的可视化对象（如图表、仪表板组件）。
可视化导出: 支持将GoodData中的可视化对象导出为图片格式（当前实现为PNG），方便在对话中展示或分享。
报告调度: 使LLM能够根据用户的指令，为特定的可视化设置定时的电子邮件报告，实现自动化数据推送。

安装步骤

确保您的系统中安装了 Node.js 运行环境。
GoodData MCP 服务器通常由兼容的 MCP 客户端根据配置自动安装和启动。客户端会使用 npm 或 npx 等工具来执行此操作。

MCP 客户端配置

要让支持 MCP 的 LLM 客户端（例如 Claude Desktop 或其他兼容应用）使用此服务器，您需要在客户端的 MCP 服务器配置中添加相应的入口。配置通常以 JSON 格式表示，指定客户端如何启动和连接到此服务器。以下是配置所需的关键信息：

服务器唯一标识 (Server Name): 为此服务器指定一个名称，例如 'gooddata'。客户端将使用此名称引用该服务器。
启动命令 (command): 运行此服务器的系统命令，通常是 'npx'。
命令参数 (args): 传递给启动命令的参数，用于指定要运行的软件包，例如 '-y andriichumak/gooddata-mcp'。
环境变量 (env): 启动服务器时需要设置必要的环境变量，以便服务器连接到您的 GoodData 账户和工作空间。这些变量包括：
- 'GOODDATA_TOKEN': 您的 GoodData API 访问令牌，用于认证。
- 'GOODDATA_HOST': 您的 GoodData 服务器主机地址（例如 'https://yourorg.gooddata.com'）。
- 'GOODDATA_WORKSPACE': 您希望此服务器操作的 GoodData 工作空间 ID。
- 'GOODDATA_NOTIFICATION_CHANNEL': 用于发送电子邮件报告的 GoodData 通知通道的 ID。

客户端配置示例如下（具体格式请参考您的 MCP 客户端文档）：

{
    "mcpServers": {
        "gooddata": { // 您为服务器指定的名称
            "command": "npx",
            "args": [ "-y andriichumak/gooddata-mcp" ],
            "env": {
                "GOODDATA_TOKEN": "请替换为您的GoodData API令牌",
                "GOODDATA_HOST": "请替换为您的GoodData服务器主机地址",
                "GOODDATA_WORKSPACE": "请替换为您的GoodData工作空间ID",
                "GOODDATA_NOTIFICATION_CHANNEL": "请替换为您的GoodData通知通道ID"
            }
        }
    }
}

请将示例中的占位符信息替换为您的实际 GoodData 凭据和配置。

基本使用方法

完成客户端配置并启动客户端后，兼容的 LLM 将能够检测到 GoodData MCP 服务器及其提供的工具（如可视化搜索、导出、调度）。当您在与 LLM 对话时，如果提到与 GoodData 数据或报告相关的任务（例如“帮我找到关于销售的可视化”、“把这个图表导出成图片”、“每天早上给我发送销售报告”），LLM 便会识别这些意图，并通过 MCP 协议调用相应的 GoodData 服务器工具来执行您的请求，并将结果返回给您。

关键词