RDL MCP Server

RDL MCP サーバー

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

2000 行を超える XML と格闘する代わりに、AI アシスタントを使って SSRS レポートを編集できます。この 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 の編集より優れている理由：

• 冗長な XML 名前空間ではなく、見やすい JSON が AI に渡されます
• エラーが起きやすい文字列操作ではなく、1 行のコマンドで操作できます
• 自動検証により、レポートに不具合が生じる前にエラーを検出します
• 依存関係は不要で、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 またはインストールドキュメントを参照してください

注： uv に付属する uvx が Python 環境と依存関係を自動的に管理するため、Python パッケージを手動でインストールする必要はありません。

クイックスタート

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

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

インストール後： AI アシスタントを再起動し、次のように試してください：「report.rdl ファイルの構造を説明して」

使用方法

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 を使う場合（コマンド 1 つ）：

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 でインストールできます）
   • server.json を MCP スキーマに照らして検証します
   • MCP Registry に公開します（サーバーがレジストリ検索に表示されます）
   • 下流のレジストリ（GitHub の MCP マーケットプレイスなど）を更新します

コントリビューション

PR を歓迎します！優先分野:

• 複雑なレイアウトでの列検出の改善
• 編集操作の拡充（並べ替え、グループ化など）

要件: Python 標準ライブラリのみ

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更とテストを行います
4. PR を送信します

ライセンス

MIT License の詳細については、LICENSE ファイルをご覧ください。

これは、商用・非商用を問わず、どのような目的でもこのソフトウェアを自由に使用、変更、配布できることを意味します。