How reportportal/reportportal-mcp-server works
ReportPortal MCP Server lets an MCP-compatible assistant query and manage ReportPortal test results and TMS assets. The principal flow is an assistant request reaching the server over stdio or HTTP, dispatching to launch, test-item, or TMS tools, and obtaining data from ReportPortal. HTTP mode also supports request-header credentials and project selection; analytics is an optional capability. The excerpts show server setup and representative API calls, but not every registration or route, so uncertain wiring is omitted or marked unverified.
Main entry points: http_server.go HTTP MCP server · server.go Stdio MCP server · tms.go TMS tools · utils.go Request utilities
Components 14
Server entry
- CLI entry
cmd/reportportal-mcp-server/main.go - CLI configuration
internal/config/cli.go
MCP transports
- Stdio MCP server
internal/reportportal/mcp_handlers/server.go - HTTP MCP server
internal/reportportal/http_server.go
ReportPortal tools
- Launch tools
internal/reportportal/mcp_handlers/launches.go - Test-item tools
internal/reportportal/mcp_handlers/items.go - TMS tools
internal/reportportal/mcp_handlers/tms.go
Shared services
- HTTP token middleware
internal/reportportal/middleware/http_token_middleware.go - API query middleware
internal/reportportal/middleware/middleware.go - Request utilities
internal/reportportal/utils/utils.go - Prompt loading
internal/promptreader/promptreader.go - Usage analytics
internal/reportportal/analytics/analytics.go
Other components
- AI assistant
- ReportPortal API
Connections 19
- AI assistant → Stdio MCP server: sends MCP requests
README.md - AI assistant → HTTP MCP server: sends MCP requests
README.md - CLI entry → CLI configuration: initializes CLI
cmd/reportportal-mcp-server/main.go - CLI entry → HTTP MCP server: runs HTTP mode
cmd/reportportal-mcp-server/main.go - CLI entry → Stdio MCP server: runs stdio mode
cmd/reportportal-mcp-server/main.go - HTTP MCP server → Launch tools: registers tools
internal/reportportal/http_server.go - HTTP MCP server → Test-item tools: registers tools
internal/reportportal/http_server.go - HTTP MCP server → HTTP token middleware: uses middleware
- Launch tools → ReportPortal API: calls API
internal/reportportal/mcp_handlers/launches.go - Test-item tools → ReportPortal API: calls API
internal/reportportal/mcp_handlers/items.go - TMS tools → ReportPortal API: calls API
internal/reportportal/mcp_handlers/tms.go - Stdio MCP server → TMS tools: registers tools
- HTTP MCP server → TMS tools: registers tools
- Stdio MCP server → Prompt loading: loads prompts
internal/reportportal/mcp_handlers/server.go - Stdio MCP server → Usage analytics: initializes analytics
internal/reportportal/mcp_handlers/server.go - Launch tools → Request utilities: uses helpers
internal/reportportal/mcp_handlers/launches.go - Test-item tools → Request utilities: uses helpers
internal/reportportal/mcp_handlers/items.go - TMS tools → Request utilities: uses helpers
internal/reportportal/mcp_handlers/tms.go - API query middleware → Request utilities: reads context
internal/reportportal/middleware/middleware.go