# reportportal/reportportal-mcp-server architecture

> Architecture diagram of the GitHub repository reportportal/reportportal-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/reportportal/reportportal-mcp-server
- Repository: https://github.com/reportportal/reportportal-mcp-server

## Overview

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: [`internal/reportportal/http_server.go`](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/http_server.go) (HTTP MCP server), [`internal/reportportal/mcp_handlers/server.go`](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/server.go) (Stdio MCP server), [`internal/reportportal/mcp_handlers/tms.go`](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/tms.go) (TMS tools), [`internal/reportportal/utils/utils.go`](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/utils/utils.go) (Request utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Server entry"]
  node_main["CLI entry<br/>[main.go]"]
  node_config["CLI configuration<br/>[cli.go]"]
end

subgraph group_transport["MCP transports"]
  node_stdio["Stdio MCP server<br/>[server.go]"]
  node_http["HTTP MCP server<br/>[http_server.go]"]
end

subgraph group_tools["ReportPortal tools"]
  node_launches["Launch tools<br/>[launches.go]"]
  node_items["Test-item tools<br/>[items.go]"]
  node_tms["TMS tools<br/>[tms.go]"]
end

subgraph group_support["Shared services"]
  node_auth["HTTP token middleware"]
  node_query["API query middleware<br/>[middleware.go]"]
  node_utils["Request utilities<br/>[utils.go]"]
  node_prompts["Prompt loading<br/>[promptreader.go]"]
  node_analytics["Usage analytics<br/>[analytics.go]"]
end

node_assistant(("AI assistant"))
node_reportportal["ReportPortal API"]

node_assistant -->|"sends MCP requests"| node_stdio
node_assistant -->|"sends MCP requests"| node_http
node_main -->|"initializes CLI"| node_config
node_main -->|"runs HTTP mode"| node_http
node_main -->|"runs stdio mode"| node_stdio
node_http -->|"registers tools"| node_launches
node_http -->|"registers tools"| node_items
node_http -.->|"uses middleware"| node_auth
node_launches -->|"calls API"| node_reportportal
node_items -->|"calls API"| node_reportportal
node_tms -->|"calls API"| node_reportportal
node_stdio -.->|"registers tools"| node_tms
node_http -.->|"registers tools"| node_tms
node_stdio -->|"loads prompts"| node_prompts
node_stdio -->|"initializes analytics"| node_analytics
node_launches -->|"uses helpers"| node_utils
node_items -->|"uses helpers"| node_utils
node_tms -->|"uses helpers"| node_utils
node_query -->|"reads context"| node_utils

click node_main "https://github.com/reportportal/reportportal-mcp-server/blob/develop/cmd/reportportal-mcp-server/main.go"
click node_config "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/config/cli.go"
click node_stdio "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/server.go"
click node_http "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/http_server.go"
click node_launches "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/launches.go"
click node_items "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/items.go"
click node_tms "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/tms.go"
click node_auth "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/middleware/http_token_middleware.go"
click node_query "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/middleware/middleware.go"
click node_utils "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/utils/utils.go"
click node_prompts "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/promptreader/promptreader.go"
click node_analytics "https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/analytics/analytics.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_config toneBlue
class node_stdio,node_http toneAmber
class node_launches,node_items,node_tms,node_reportportal toneMint
class node_auth,node_query,node_utils,node_prompts,node_analytics toneRose
class node_assistant toneIndigo
```

## Components

### Server entry

- [CLI entry](https://github.com/reportportal/reportportal-mcp-server/blob/develop/cmd/reportportal-mcp-server/main.go): `cmd/reportportal-mcp-server/main.go`
- [CLI configuration](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/config/cli.go): `internal/config/cli.go`

### MCP transports

- [Stdio MCP server](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/server.go): `internal/reportportal/mcp_handlers/server.go`
- [HTTP MCP server](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/http_server.go): `internal/reportportal/http_server.go`

### ReportPortal tools

- [Launch tools](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/launches.go): `internal/reportportal/mcp_handlers/launches.go`
- [Test-item tools](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/items.go): `internal/reportportal/mcp_handlers/items.go`
- [TMS tools](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/mcp_handlers/tms.go): `internal/reportportal/mcp_handlers/tms.go`

### Shared services

- [HTTP token middleware](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/middleware/http_token_middleware.go): `internal/reportportal/middleware/http_token_middleware.go`
- [API query middleware](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/middleware/middleware.go): `internal/reportportal/middleware/middleware.go`
- [Request utilities](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/utils/utils.go): `internal/reportportal/utils/utils.go`
- [Prompt loading](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/promptreader/promptreader.go): `internal/promptreader/promptreader.go`
- [Usage analytics](https://github.com/reportportal/reportportal-mcp-server/blob/develop/internal/reportportal/analytics/analytics.go): `internal/reportportal/analytics/analytics.go`

### Other components

- **AI assistant**
- **ReportPortal API**

## Connections

- AI assistant → Stdio MCP server: sends MCP requests (evidence: `README.md`)
- AI assistant → HTTP MCP server: sends MCP requests (evidence: `README.md`)
- CLI entry → CLI configuration: initializes CLI (evidence: `cmd/reportportal-mcp-server/main.go`)
- CLI entry → HTTP MCP server: runs HTTP mode (evidence: `cmd/reportportal-mcp-server/main.go`)
- CLI entry → Stdio MCP server: runs stdio mode (evidence: `cmd/reportportal-mcp-server/main.go`)
- HTTP MCP server → Launch tools: registers tools (evidence: `internal/reportportal/http_server.go`)
- HTTP MCP server → Test-item tools: registers tools (evidence: `internal/reportportal/http_server.go`)
- HTTP MCP server → HTTP token middleware: uses middleware
- Launch tools → ReportPortal API: calls API (evidence: `internal/reportportal/mcp_handlers/launches.go`)
- Test-item tools → ReportPortal API: calls API (evidence: `internal/reportportal/mcp_handlers/items.go`)
- TMS tools → ReportPortal API: calls API (evidence: `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 (evidence: `internal/reportportal/mcp_handlers/server.go`)
- Stdio MCP server → Usage analytics: initializes analytics (evidence: `internal/reportportal/mcp_handlers/server.go`)
- Launch tools → Request utilities: uses helpers (evidence: `internal/reportportal/mcp_handlers/launches.go`)
- Test-item tools → Request utilities: uses helpers (evidence: `internal/reportportal/mcp_handlers/items.go`)
- TMS tools → Request utilities: uses helpers (evidence: `internal/reportportal/mcp_handlers/tms.go`)
- API query middleware → Request utilities: reads context (evidence: `internal/reportportal/middleware/middleware.go`)
