RDL MCP Server

RDL MCP 服务

mcp-name: io.github.bethmaloney/rdl-mcp

使用 AI 助手编辑 SSRS 报表，无需再费力处理 2000 多行 XML。这个 Model Context Protocol (MCP) 服务为 Claude、Copilot 和其他 AI 工具提供简单的命令，用于读取和修改 RDL 文件。

功能介绍

读取报表：

• describe_rdl_report - 获取报表结构概览
• get_rdl_datasets - 查看数据集、字段和存储过程（支持限制字段数量和筛选）
• get_rdl_parameters - 列出所有报表参数
• get_rdl_columns - 查看列标题、宽度和绑定

修改报表：

• update_column_header / update_column_width - 更改列
• add_column / remove_column - 添加或移除列
• update_column_format - 更改数字/日期格式
• update_stored_procedure - 替换存储过程
• add_dataset_field / remove_dataset_field - 管理数据集字段
• add_parameter / update_parameter - 管理参数
• validate_rdl - 在修改后验证 XML

比编辑 XML 更好的原因：

• AI 看到的是清晰的 JSON，而不是冗长的 XML 命名空间
• 使用单行命令，无需进行容易出错的字符串操作
• 自动验证可在错误导致报表无法使用前将其捕获
• 无依赖项——仅需 Python 3.8+ 标准库

安装

要求：

• Python 3.8 或更高版本
• uv（Python 包管理器和工具运行器）

安装 uv：

• macOS/Linux： curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows： powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
• 其他方式（所有平台）： pip install uv，或参阅安装文档

注意： uvx（包含在 uv 中）会自动处理 Python 环境和依赖项。无需手动安装 Python 包！

快速开始

{
  "mcpServers": {
    "rdl-mcp": {
      "command": "uvx",
      "args": ["rdl-mcp"]
    }
  }
}

{
  "servers": {
    "rdlMcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["rdl-mcp"]
    }
  }
}

安装完成后： 重启 AI 助手并尝试提问："Describe the structure of my report.rdl file"

用法

只需用自然语言向 AI 助手提问：

• “这个报表使用了哪些数据集？”
• “将 Account Number 列的宽度设为 2 英寸”
• “将 Amount 列格式设为保留 2 位小数的货币格式”
• “添加一个新的 Amount 列，在页脚显示总和”
• “添加 Status 列，但保持页脚为空”
• “将主数据集更新为使用 V2 存储过程，并添加 TaxAmount 字段”
• “移除已过时的 Status 列”
• “添加 Year 参数以筛选报表”

AI 助手会自动使用相应的 MCP 工具。

示例：编辑方式对比 XML

不使用 MCP（手动编辑 XML）：

<TablixCell><CellContents><Textbox><Paragraphs>
  <Paragraph><TextRuns><TextRun>
    <Value>Old Header</Value>
  </TextRun></TextRuns></Paragraph>
</Paragraphs></Textbox></CellContents></TablixCell>

使用 MCP（一条命令）：

update_column_header(filepath="report.rdl",
                     old_header="Old Header",
                     new_header="New Header")

API 参考

限制与路线图

当前限制：

• 仅支持 Tablix（表格）控件，暂不支持 Matrix 或 Chart
• 最适用于标准报告布局
• 某些复杂的 RDL 功能可能仍需手动编辑 XML

计划中的功能：

• 列重新排序、分组和排序配置
• 表达式构建器辅助工具
• 数据集字段管理

故障排除

未显示服务？

• 检查配置中的绝对路径是否正确
• 确认 Python 3.8+：python3 --version
• 重启 MCP 客户端

权限错误？

• 使脚本可执行：chmod +x rdl_mcp_server.py
• 检查 RDL 文件的读写权限

发布新版本

此服务发布在 PyPI 和 MCP Registry 上。发布新版本的步骤如下：

1. 更新两个文件中的版本号：

   pyproject.toml：

   version = "0.2.0"
   

   server.json：

   {
     "version": "0.2.0",
     "packages": [
       {
         "version": "0.2.0"
       }
     ]
   }
   

2. 提交更改：

   git add .
   git commit -m "Release v0.2.0: Add feature description"
   

3. 创建并推送 git 标签：

   git tag v0.2.0
   git push origin main --tags
   

4. 自动发布：GitHub Actions 工作流会自动：

   • 构建并发布到 PyPI（用户可以通过 uvx rdl-mcp 安装）
   • 根据 MCP schema 验证 server.json
   • 发布到 MCP Registry（服务会显示在注册表搜索结果中）
   • 更新下游注册表（例如 GitHub 的 MCP marketplace）

贡献

欢迎提交 PR！优先改进方向：

• 改进对复杂布局的列检测
• 增加更多编辑操作（重新排序、分组等）

要求：仅使用 Python 标准库

1. Fork 仓库
2. 创建功能分支
3. 进行更改并添加测试
4. 提交 PR

许可证

MIT License - 详情请参阅 LICENSE 文件。

这意味着你可以出于任何目的（无论商业或非商业）自由使用、修改和分发此软件。