jasperreports

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.

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

View docs

Command

claude mcp add --transport stdio mr-wolf-gb-jasperreports-mcp-server npx jasperreports-mcp-server \
  --env JASPER_URL="Description: JasperReports Server base URL (e.g., http://localhost:8080/jasperserver)" \
  --env JASPER_TIMEOUT="Description: Request timeout in milliseconds (optional, default 30000)" \
  --env JASPER_PASSWORD="Description: JasperReports Server password" \
  --env JASPER_USERNAME="Description: JasperReports Server username" \
  --env JASPER_AUTH_TYPE="Description: Authentication type (basic | login | argument)" \
  --env JASPER_DEBUG_MODE="Description: Enable debug logging (true/false, optional)" \
  --env JASPER_SSL_VERIFY="Description: Verify SSL certificates (true/false, optional)" \
  --env JASPER_ORGANIZATION="Description: Organization for multi-tenant setups (optional)"

How to use

This MCP server provides a Node.js implementation for interacting with JasperReports Server REST API v2 through the MCP (Model Context Protocol). It exposes a suite of MCP tools that allow an AI assistant or IDE to authenticate, list and manage resources, execute reports, schedule jobs, and perform administrative tasks against JasperReports Server from within MCP-enabled environments. Developers can integrate the server into IDEs like Cursor, Kiro, Windsurf, Claude Desktop, or other MCP-compatible tools to automate JasperReports workflows via standardized MCP endpoints and tool definitions. The server supports multiple authentication methods, resource operations (CRUD for reports and resources), synchronous and asynchronous report execution, parameter handling, and administrative capabilities such as user, role, and permission management. Configuration is driven by environment variables, enabling secure and flexible deployment in local, CI, or production environments.

How to install

Prerequisites:

Node.js v18 or later installed on the host
npm (comes with Node.js)
Access to JasperReports Server instance

Installation steps:

Install the MCP server globally (recommended):

npm install -g jasperreports-mcp-server

Configure environment variables (example):

cp .env.example .env

Edit .env to provide:

JASPER_URL: JasperReports Server URL
JASPER_USERNAME: JasperReports username
JASPER_PASSWORD: JasperReports password
JASPER_AUTH_TYPE: auth method (basic|login|argument)

3) Start the MCP server:

npm start

4) (Optional) Run in development mode with auto-reload:

npm run dev

5) (Optional) Run the HTTP test server for endpoint testing:

npm run test-server

Additional notes

Environment variables drive runtime behavior. Ensure JASPER_URL, JASPER_USERNAME, and JASPER_PASSWORD are securely configured. If you enable JASPER_SSL_VERIFY, verify SSL certificates accordingly. The TIMEOUT setting can help in environments with slower JasperServers. For production deployments, consider using a secure secret store or environment management system to inject credentials. If authentication fails, check JASPER_AUTH_TYPE compatibility with your JasperReports Server configuration. The MCP server is designed to be MCP-compatible across IDEs, but individual IDE configurations may require minor adjustments to the environment variables layout shown in the README examples.

Related MCP Servers

PPTAgent

3.4k

An Agentic Framework for Reflective PowerPoint Generation

rtfmbro

rtfmbro provides always-up-to-date, version-specific package documentation as context for coding agents. An alternative to context7

zerodha

Zerodha MCP Server & Client - AI Agent (w/Agno & w/Google ADK)

openai -agent-dotnet

Sample to create an AI Agent using OpenAI models with any MCP server running on Azure Container Apps

Common_Chronicle

Common Chronicle turns messy context into structured, sourced timelines.

fast -telegram

Telegram MCP Server and HTTP-MTProto bridge | Multi-user auth, intelligent search, file sending, web setup | Docker & PyPI ready