# getsentry/sentry-mcp architecture

> Architecture diagram of the GitHub repository getsentry/sentry-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/getsentry/sentry-mcp
- Repository: https://github.com/getsentry/sentry-mcp

## Overview

##### Project type and purpose
- From the file tree we see a pnpm/turbo-powered monorepo hosting several related packages.
- Core packages:
- packages/mcp-server         – The core CLI/tooling library with transports (stdio), command definitions, prompts, and internal logic.
- packages/mcp-server-evals   – The suite of “eval” functions (autofix, create-project, list-issues, etc.) that implement the CLI’s commands.
- packages/mcp-server-mocks   – Test fixtures and mock servers for mcp-server and mcp-server-evals.
- packages/mcp-cloudflare     – A full-stack Cloudflare Worker + React/Vite frontend integration for a UI (OAuth, setup guides, Sentry).
- packages/mcp-server-tsconfig – Shared TypeScript configs used across packages.
- This is primarily a developer-tool suite: a CLI with pluggable “eval” modules, local mocks for dev/test, and an optional Cloudflare-hosted UI.

##### File structure
- Top-level:
- bin/                       – Scripts (version bump).
- .github/workflows/         – CI (tests, merges, releases).
- Dockerfile                 – Containerization.
- turbo.json, pnpm-workspace.yaml – Turbo and pnpm workspace configs.
- packages/mcp-server:
- src/transports/stdio.ts    – How the CLI communicates.
- src/toolDefinitions.ts     – CLI commands declarative schema.
- src/prompts.ts             – Interactive prompts.
- packages/mcp-server-evals:
- src/evals/*.eval.ts        – Each file implements one command’s business logic.
- packages/mcp-server-mocks:
- fixtures/                  – JSON fixtures of API states.
- index.ts                   – Mock HTTP/stdio server implementation.
- packages/mcp-cloudflare:
- src/client                – React/Vite UI.
- src/server                – Worker routes (OAuth, transport layer).
- wrangler.jsonc            – Cloudflare Worker config.
- vite.config.ts, tsconfigs – Build and type configs.

##### README (unavailable)
- No usable content, so we infer from filenames and directory patterns.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Monorepo Root & Tooling"
        rootPW["pnpm-workspace.yaml"]:::infra
        rootTurbo["turbo.json"]:::infra
        rootPkg["package.json"]:::infra
        rootDocker["Dockerfile"]:::infra
        rootBump["bump-version.sh"]:::infra
    end

    subgraph "Shared TypeScript Configs"
        tsBase["tsconfig.base.json"]:::tooling
        tsVite["tsconfig.vite.json"]:::tooling
        tsPkg["package.json"]:::tooling
    end

    subgraph "CLI Runtime (mcp-server)" 
        cliPkg["package.json"]:::core
        cliIndex["src/index.ts"]:::core
        cliDefs["src/toolDefinitions.ts"]:::core
        cliPrompts["src/prompts.ts"]:::core
        cliStdio["src/transports/stdio.ts"]:::core
        cliAPI["src/api-client/client.ts"]:::core
        cliFmt["src/internal/formatting.ts"]:::core
    end

    subgraph "Eval Modules (mcp-server-evals)"
        evalPkg["package.json"]:::core
        startMock["src/bin/start-mock-stdio.ts"]:::core
        evalFiles["src/evals/*.eval.ts"]:::core
    end

    subgraph "Mocks for Testing (mcp-server-mocks)"
        mocksPkg["package.json"]:::tooling
        mocksIndex["src/index.ts"]:::tooling
        fixtures["src/fixtures/*.json"]:::tooling
    end

    subgraph "Cloudflare Deployment (mcp-cloudflare)"
        cloudPkg["package.json"]:::cloud
        wrangler["wrangler.jsonc"]:::cloud
        viteCFG["vite.config.ts"]:::cloud
        clientMain["src/client/main.tsx"]:::cloud
        clientApp["src/client/App.tsx"]:::cloud
        clientUI["src/client/components/ui/*"]:::cloud
        clientFrag["src/client/components/fragments/*"]:::cloud
        serverIndex["src/server/index.ts"]:::cloud
        serverApp["src/server/app.ts"]:::cloud
        routeOAuth["src/server/routes/sentry-oauth.ts"]:::cloud
        libOAuth["src/server/lib/oauth.ts"]:::cloud
        libTrans["src/server/lib/mcp-transport.ts"]:::cloud
    end

    subgraph "CI/CD & Deployment"
        testWF["test.yml"]:::infra
        releaseWF["release.yml"]:::infra
        evalWF["eval.yml"]:::infra
        mergeWF["merge-jobs.yml"]:::infra
    end

    Sentry["Sentry (External API)"]:::external

    %% Dependencies
    rootPW --> tsPkg
    rootTurbo --> tsPkg
    rootPW --> cliPkg
    rootPW --> evalPkg
    rootPW --> mocksPkg
    rootPW --> cloudPkg
    rootPW --> testWF

    tsPkg --> cliPkg
    tsPkg --> evalPkg
    tsPkg --> mocksPkg
    tsPkg --> cloudPkg

    cliIndex --> cliDefs
    cliIndex --> cliPrompts
    cliIndex --> cliStdio
    cliIndex --> cliAPI
    cliIndex --> cliFmt

    cliStdio -->|"invokes"| evalFiles
    cliStdio -->|"mock mode?"| mocksIndex

    evalFiles -->|"uses mocks?"| mocksIndex

    serverApp -->|"proxies to"| evalFiles
    serverApp -->|"uses mocks?"| mocksIndex
    serverApp -->|"calls external"| Sentry

    clientMain -->|"HTTP/JSON"| serverIndex
    clientApp --> serverIndex

    serverIndex --> serverApp
    routeOAuth --> serverApp
    libOAuth --> serverApp
    libTrans --> serverApp

    testWF --> cliPkg
    testWF --> evalPkg
    testWF --> mocksPkg
    testWF --> cloudPkg

    releaseWF --> cliPkg
    releaseWF --> evalPkg
    releaseWF --> cloudPkg

    evalWF --> evalPkg
    mergeWF --> cliPkg
    mergeWF --> evalPkg
    mergeWF --> mocksPkg
    mergeWF --> cloudPkg

    %% Click Events
    click rootPW "https://github.com/getsentry/sentry-mcp/blob/main/pnpm-workspace.yaml"
    click rootTurbo "https://github.com/getsentry/sentry-mcp/blob/main/turbo.json"
    click rootPkg "https://github.com/getsentry/sentry-mcp/blob/main/package.json"
    click rootDocker "https://github.com/getsentry/sentry-mcp/tree/main/Dockerfile"
    click rootBump "https://github.com/getsentry/sentry-mcp/blob/main/bin/bump-version.sh"

    click tsBase "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-tsconfig/tsconfig.base.json"
    click tsVite "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-tsconfig/tsconfig.vite.json"
    click tsPkg "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-tsconfig/package.json"

    click cliPkg "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server/package.json"
    click cliIndex "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server/src/index.ts"
    click cliDefs "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server/src/toolDefinitions.ts"
    click cliPrompts "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server/src/prompts.ts"
    click cliStdio "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server/src/transports/stdio.ts"
    click cliAPI "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server/src/api-client/client.ts"
    click cliFmt "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server/src/internal/formatting.ts"

    click evalPkg "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-evals/package.json"
    click startMock "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-evals/src/bin/start-mock-stdio.ts"
    click evalFiles "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-evals/src/evals/*.eval.ts"

    click mocksPkg "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-mocks/package.json"
    click mocksIndex "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-mocks/src/index.ts"
    click fixtures "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-server-mocks/src/fixtures/*.json"

    click cloudPkg "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/package.json"
    click wrangler "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/wrangler.jsonc"
    click viteCFG "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/vite.config.ts"
    click clientMain "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/src/client/main.tsx"
    click clientApp "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/src/client/App.tsx"
    click clientUI "https://github.com/getsentry/sentry-mcp/tree/main/packages/mcp-cloudflare/src/client/components/ui/*"
    click clientFrag "https://github.com/getsentry/sentry-mcp/tree/main/packages/mcp-cloudflare/src/client/components/fragments/*"
    click serverIndex "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/src/server/index.ts"
    click serverApp "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/src/server/app.ts"
    click routeOAuth "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/src/server/routes/sentry-oauth.ts"
    click libOAuth "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/src/server/lib/oauth.ts"
    click libTrans "https://github.com/getsentry/sentry-mcp/blob/main/packages/mcp-cloudflare/src/server/lib/mcp-transport.ts"

    click testWF "https://github.com/getsentry/sentry-mcp/blob/main/.github/workflows/test.yml"
    click releaseWF "https://github.com/getsentry/sentry-mcp/blob/main/.github/workflows/release.yml"
    click evalWF "https://github.com/getsentry/sentry-mcp/blob/main/.github/workflows/eval.yml"
    click mergeWF "https://github.com/getsentry/sentry-mcp/blob/main/.github/workflows/merge-jobs.yml"

    %% Styles
    classDef tooling fill:#a6f3a6,stroke:#333,stroke-width:1px
    classDef core fill:#a6c8f0,stroke:#333,stroke-width:1px
    classDef cloud fill:#f0a76a,stroke:#333,stroke-width:1px
    classDef infra fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef external fill:#eeeeee,stroke:#333,stroke-width:1px
```
