Skip to main content
Glama
naveen-bitrise

Bitrise Insights MCP Server

README.md
# Bitrise Insights MCP Server

A hacky bitrise insights mcp using playwright till Bitrise Insights API is released.

## Installation

Clone the repository and build:

```bash
git clone https://github.com/naveen-bitrise/temp-bitrise-insights-mcp.git
cd temp-bitrise-insights-mcp
npm install
npx playwright install
npm run build
```

## Usage

### MCP Configuration

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "bitrise-insights": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/temp-bitrise-insights-mcp",
      "type": "stdio"
    }
  }
}
```

**Example for macOS/Linux:**
```json
{
  "mcpServers": {
    "bitrise-insights": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/Users/yourname/temp-bitrise-insights-mcp",
      "type": "stdio"
    }
  }
}
```

**Example for Windows:**
```json
{
  "mcpServers": {
    "bitrise-insights": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "C:\\Users\\yourname\\temp-bitrise-insights-mcp",
      "type": "stdio"
    }
  }
}
```

### Available Tools

- **`bitrise-insights-get-flaky-tests`**: Get comprehensive flaky tests data from Bitrise Insights

### Authentication

A browser window will open automatically when Bitrise login is required. Complete the login and the tool will continue automatically.

## Tool Parameters

```typescript
{
  workspace_slug: string,           // Required: Bitrise workspace slug
  app_slug?: string,               // Optional: Specific app slug  
  interval?: string,               // Optional: hourly, daily, weekly, monthly (default: monthly)
  duration?: string,               // Optional: e.g. "july", "last week", "P6M" (default: P6M)
  include_test_cases?: boolean,    // Optional: Include detailed test cases (default: false)
  specific_test?: {                // Optional: Get details for specific test
    test_case_name: string,
    test_suite_name?: string
  }
}
```

## Example Queries

- "Get flaky tests for workspace 'my-workspace' for the last 6 months"
- "Show me detailed test cases for app 'my-app' in workspace 'my-workspace'"  
- "Get builds data for test case 'LoginTest' in suite 'AuthSuite'"

## Requirements

- Node.js 18+
- Internet connection for browser authentication

## Development

```bash
git clone https://github.com/naveen-bitrise/temp-bitrise-insights-mcp.git
cd temp-bitrise-insights-mcp
npm install
npm run dev
```

## License

MIT

TDQS

A4/5.0

Scored across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusing it with another tool. Its purpose is clearly limited to retrieving flaky test data.

Naming Consistency5/5

The single tool name follows a clear action-oriented convention: bitrise-insights-get-flaky-tests. There is no mixed naming style or contradictory pattern to cause confusion.

Tool Count2/5

A single tool is too few for a server named Bitrise Insights, which implies a broader analytics surface. While it may handle a narrow flaky-test workflow, it feels under-scoped.

Completeness2/5

The server only exposes flaky-test retrieval, with no tools for other Bitrise Insights data such as builds, test suites, trends, or general analytics. This is a significant coverage gap for the implied domain.

Maintenance

ActivityInactive
ResponsivenessNo issues