Claude Desktop

\n\nEdit config file:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux:** `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"rdl-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"rdl-mcp\"]\n }\n }\n}\n```\n

\n\n

GitHub Copilot (VSCode)

\n\nAdd to VSCode settings (`.vscode/mcp.json` in your workspace or user settings):\n\n```json\n{\n \"servers\": {\n \"rdlMcp\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\"rdl-mcp\"]\n }\n }\n}\n```\n\n**Note:** Requires VSCode with Copilot Chat extension installed.\n

\n\n\n**After installation:** Restart your AI assistant and try: `\"Describe the structure of my report.rdl file\"`\n\n

Optional: Enable debug logging

\n\nSet environment variables:\n- `RDL_MCP_LOG_LEVEL`: `DEBUG`, `INFO`, `WARNING`, or `ERROR`\n- `RDL_MCP_LOG_FILE`: Path to log file\n

\n\n## Usage\n\nJust ask your AI assistant in natural language:\n\n- \"What datasets does this report use?\"\n- \"Make the Account Number column 2 inches wide\"\n- \"Format the Amount column as currency with 2 decimals\"\n- \"Add a new Amount column that shows the sum in the footer\"\n- \"Add a Status column but leave the footer blank\"\n- \"Update the main dataset to use the V2 stored procedure and add the TaxAmount field\"\n- \"Remove the obsolete Status column\"\n- \"Add a Year parameter to filter the report\"\n\nThe AI assistant will use the appropriate MCP tools automatically.\n\n## Example: Editing vs. XML\n\n**Without MCP** (manually editing XML):\n```xml\n\n\n \n Old Header\n \n\n```\n\n**With MCP** (one command):\n```python\nupdate_column_header(filepath=\"report.rdl\",\n old_header=\"Old Header\",\n new_header=\"New Header\")\n```\n\n## API Reference\n\n

View all available tools

\n\n### Reading Tools\n\n- **`describe_rdl_report(filepath)`** - Report structure summary\n- **`get_rdl_datasets(filepath, field_limit?, field_pattern?)`** - Datasets with fields and stored procedures\n - `field_limit`: 0 = counts only (default), -1 = all fields, N = limit to N fields\n - `field_pattern`: Optional regex to filter field names\n- **`get_rdl_parameters(filepath)`** - All parameters with configurations\n- **`get_rdl_columns(filepath)`** - Column headers, widths, bindings\n\n### Editing Tools\n\n- **`update_column_header(filepath, old_header, new_header)`** - Change column text\n- **`update_column_width(filepath, column_index, new_width)`** - Modify width (e.g. \"2.5in\")\n- **`update_column_format(filepath, column_index, format_string)`** - Change format (e.g. \"#,0.00\", \"dd/MM/yyyy\", \"C2\")\n- **`add_column(filepath, column_index, header_text, field_binding, width?, format_string?, footer_expression?)`** - Add column\n - `footer_expression`: Optional expression for footer/total row - e.g. \"=Sum(Fields!Amount.Value)\", \"=Count(Fields!ID.Value)\", \"Total:\", or leave empty\n- **`remove_column(filepath, column_index)`** - Remove column\n- **`update_stored_procedure(filepath, dataset_name, new_sproc)`** - Change dataset sproc\n- **`add_dataset_field(filepath, dataset_name, field_name, data_field, type_name)`** - Add field to dataset\n- **`remove_dataset_field(filepath, dataset_name, field_name)`** - Remove field from dataset\n- **`add_parameter(filepath, name, data_type, prompt)`** - Add new parameter\n- **`update_parameter(filepath, name, prompt?, default_value?)`** - Update parameter\n- **`validate_rdl(filepath)`** - Validate XML structure\n\nAll tools return `{success: bool, message?: string, error?: string}` or structured data.\n\n

\n\n## Limitations & Roadmap\n\n**Current limitations:**\n- Tablix (table) controls only - no Matrix or Chart support yet\n- Works best with standard report layouts\n- Some complex RDL features may still need manual XML editing\n\n**Planned features:**\n- Column reordering, grouping, and sorting configuration\n- Expression builder helpers\n- Dataset field management\n\n## Troubleshooting\n\n**Server not appearing?**\n- Check absolute path in config is correct\n- Verify Python 3.8+: `python3 --version`\n- Restart your MCP client\n\n**Permission errors?**\n- Make script executable: `chmod +x rdl_mcp_server.py`\n- Check RDL file read/write permissions\n\n\n\n## Releasing a New Version\n\nThis server is published to [PyPI](https://pypi.org/project/rdl-mcp/) and the [MCP Registry](https://registry.modelcontextprotocol.io/). To release a new version:\n\n1. **Update version numbers** in both files:\n\n `pyproject.toml`:\n ```toml\n version = \"0.2.0\"\n ```\n\n `server.json`:\n ```json\n {\n \"version\": \"0.2.0\",\n \"packages\": [\n {\n \"version\": \"0.2.0\"\n }\n ]\n }\n ```\n\n2. **Commit your changes**:\n ```bash\n git add .\n git commit -m \"Release v0.2.0: Add feature description\"\n ```\n\n3. **Create and push a git tag**:\n ```bash\n git tag v0.2.0\n git push origin main --tags\n ```\n\n4. **Automated publishing**: The GitHub Actions workflows automatically:\n - Build and publish to PyPI (users can install via `uvx rdl-mcp`)\n - Validate `server.json` against the MCP schema\n - Publish to the MCP Registry (server appears in registry search)\n - Update downstream registries (like GitHub's MCP marketplace)\n\n## Contributing\n\nPRs welcome! Priority areas:\n- Better column detection for complex layouts\n- More editing operations (reordering, grouping, etc.)\n\nRequirements: Python standard library only\n\n1. Fork repo\n2. Create feature branch\n3. Make changes + tests\n4. Submit PR\n\n## License\n\nMIT License - see [LICENSE](https://github.com/bethmaloney/rdl-mcp/blob/main/LICENSE) file for details.\n\nThis means you're free to use, modify, and distribute this software for any purpose, commercial or non-commercial.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_96":97,"_98":99,"_100":101,"_102":103,"_104":66,"_105":106},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_94":81,"_95":81},"ratingAvg","reviewCount","topics",[],"license","MIT","language","Python","registryName","io.github.bethmaloney/rdl-mcp","homepage","packages",[107],{"_108":109,"_110":21,"_71":72},"registryType","pypi","identifier","ENV",{"_113":114,"_115":116,"_117":118},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

RDL MCP Server