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
MITTDQS
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