JasperReports MCP Server

A comprehensive Node.js Model Context Protocol (MCP) server for JasperReports Server REST API v2. This server enables AI assistants and developers to perform all major JasperReports operations including authentication, resource management, report execution, job scheduling, and administrative tasks through standardized MCP tools.

Perfect for integrating JasperReports functionality into AI-powered IDEs like Cursor, Kiro, Windsurf, Claude Desktop, and any other MCP-compatible development environment.

Features

• 🔌 MCP Compatible: Works seamlessly with Cursor, Kiro, Windsurf, and other MCP-enabled IDEs
• 🔐 Complete JasperReports Integration: Full support for JasperReports Server REST API v2
• 🔑 Multiple Authentication Methods: Basic, login service, and argument-based authentication
• 📁 Resource Management: Upload, list, update, and delete reports and resources
• 📊 Report Execution: Synchronous and asynchronous report generation in multiple formats (PDF, Excel, CSV, etc.)
• ⏰ Job Scheduling: Create and manage scheduled report jobs with cron expressions
• 🎛️ Input Controls: Handle report parameters and cascading controls
• 👥 Administrative Tools: User, role, and permission management
• 🧪 Test Server: HTTP endpoint for testing and validation
• 🛡️ Enterprise Ready: SSL support, timeout handling, and comprehensive error management
• 📝 Comprehensive Logging: Debug and production logging with configurable levels

IDE Integration

Cursor IDE

1. Install the MCP server globally:

npm install -g jasperreports-mcp-server

2. Add to your Cursor settings (.cursor-settings/mcp.json):

{
  "mcpServers": {
    "jasperreports-server": {
      "command": "npx",
      "args": ["jasperreports-mcp-server"],
      "env": {
        "JASPER_URL": "http://localhost:8080/jasperserver",
        "JASPER_USERNAME": "jasperadmin",
        "JASPER_PASSWORD": "jasperadmin",
        "JASPER_AUTH_TYPE": "basic"
      }
    }
  }
}

Kiro IDE

1. Install the server:

npm install -g jasperreports-mcp-server

2. Configure in .kiro/settings/mcp.json:

{
  "mcpServers": {
    "jasperreports-server": {
      "command": "jasperreports-mcp-server",
      "env": {
        "JASPER_URL": "http://localhost:8080/jasperserver",
        "JASPER_USERNAME": "jasperadmin",
        "JASPER_PASSWORD": "jasperadmin"
      },
      "autoApprove": [
        "jasper_authenticate",
        "jasper_test_connection",
        "jasper_list_resources"
      ]
    }
  }
}

Windsurf IDE

1. Install globally:

npm install -g jasperreports-mcp-server

2. Add to Windsurf MCP configuration:

{
  "mcpServers": {
    "jasperreports-server": {
      "command": "npx",
      "args": ["jasperreports-mcp-server"],
      "env": {
        "JASPER_URL": "https://your-jasper-server.com/jasperserver",
        "JASPER_USERNAME": "your-username",
        "JASPER_PASSWORD": "your-password",
        "JASPER_SSL_VERIFY": "true"
      }
    }
  }
}

Claude Desktop

1. Install the server:

npm install -g jasperreports-mcp-ser

... [View full README on GitHub](https://github.com/mr-wolf-gb/jasperreports-mcp-server#readme)