内容
# JasperReportsMCP
**JasperReports 的 MCP 服务器 - 完全基于 Java MCP SDK 和 JasperReports 库**
JasperReportsMCP 将 JasperReports 暴露为 MCP 工具,任何兼容的 AI 代理都可以直接调用:在不离开代理工作流的情况下,将 `.jrxml` 报告模板与实际的 JasperReports 编译进行验证。
## 快速开始
从最新版本中下载 `jasperreportsmcp.jar` 并将其添加到您的 MCP 客户端配置中:
```json
{
"mcpServers": {
"JasperReportsMCP": {
"type": "local",
"command": "java",
"args": ["-jar", "/path/to/jasperreportsmcp.jar"]
}
}
}
```
## 工具
| 工具 | 输入 | 输出 |
|------|-------|--------|
| `validate-jrxml-file` | `path`: `.jrxml` 的绝对路径(必填)<br>`data`: 以逗号分隔的字段名称(可选) | `"验证成功"` 或编译错误 |
`data` 在编译前将额外字段注入为 `java.lang.String` — 对于模板通过 `$F{fieldName}` 引用数据源字段但未在 `.jrxml` 中声明的情况非常有用。
## 构建
```bash
./mvnw test # 运行测试
./mvnw package # 打包 jar
```
## 技术栈
- Java 25
- [MCP Java SDK](https://github.com/modelcontextprotocol/java-sdk) v1.1.2
- [JasperReports](https://community.jaspersoft.com) v7.0.6 _(v6 支持正在评估中)_