Jenkins MCP Server

MCP (Model Context Protocol) server for interacting with Jenkins at jenkins.scylladb.com. Provides tools for listing jobs, viewing builds, reading console output, triggering builds, and more.

Setup

Prerequisites

npm install

Credentials

The server uses these environment variables for authentication:

Step 1: Get your Jenkins username

Your Jenkins username is the same as your ScyllaDB LDAP / SSO username. You can verify it by logging in to https://jenkins.scylladb.com and checking the name shown in the top-right corner.

Step 2: Generate an API token

1. Log in to https://jenkins.scylladb.com
2. Click your name in the top-right corner → Configure (or go directly to https://jenkins.scylladb.com/user/<your-username>/configure)
3. Scroll down to the API Token section
4. Click Add new Token, give it a descriptive name (e.g. claude-code-mcp), and click Generate
5. Copy the token immediately — it is shown only once

Step 3: Verify access

Test that your credentials work:

curl -u "your-username:your-api-token" https://jenkins.scylladb.com/api/json?tree=mode

You should see {"mode":"NORMAL"} (or similar). If you get a 401/403, double-check your username and token.

Adding to Claude Code

Add the server to your Claude Code MCP configuration. Edit (or create) the file ~/.claude/settings.json:

{
  "mcpServers": {
    "jenkins": {
      "command": "node",
      "args": ["/path/to/jenkins-mcp/server.js"],
      "env": {
        "JENKINS_USER": "your-username",
        "JENKINS_TOKEN": "your-api-token"
      }
    }
  }
}

Replace /path/to/jenkins-mcp/server.js with the absolute path to server.js, and fill in your credentials. JENKINS_URL defaults to https://jenkins.scylladb.com and can be omitted.

You can also configure it at the project level by creating a .mcp.json file in the project root (this format is shared with OpenAI Codex):

{
  "mcpServers": {
    "jenkins": {
      "command": "node",
      "args": ["./server.js"],
      "env": {
        "JENKINS_USER": "your-username",
        "JENKINS_TOKEN": "your-api-token"
      }
    }
  }
}

Adding to OpenAI Codex

Codex uses the same .mcp.json project-level configuration as Claude Code (see above). Place the .mcp.json file in the project root and Codex will pick it up automatically.

Running Standalone (for testing)

JENKINS_USER=your-username JENKINS_TOKEN=your-api-token node server.js

The server communicates over stdio using the MCP protocol — it is not meant to be used directly from a terminal, but this verifies it starts without errors.

Development

Linting

npm run lint

Uses ESLint 9 with flat config (eslint.config.js).

CI/CD

GitHub Actions runs on every push and PR to main:

• Lint — npx eslint . with Node 20

Driver Tests Overview

The Jenkins folder scylla-master/driver-tests contains CI jobs that test ScyllaDB compatibility with various CQL client drivers.

How Driver Tests Work

Each driver test job:

1. Spins up a ScyllaDB cluster (typically via CCM)
2. Runs the driver's test suite against it across multiple driver versions and protocol versions
3. Reports results to Argus

The test infrastructure for each driver lives in a driver-matrix repo. These repos contain the configuration (which driver versions to test, which tests to run, version-specific workarounds, etc.). The actual driver source code lives in separate driver repos — ScyllaDB forks of upstream drivers (or ScyllaDB-native drivers in the case of Rust).

Job → Repository Mapping

Where to File Issues

• Test infrastructure issues (flaky tests, missing versions, matrix config problems) → file in the driver-matrix repo
• Driver bugs (incorrect behavior, crashes, protocol issues) → file in the driver repo
• ScyllaDB server bugs (discovered via driver tests) → file in scylladb/scylladb

Available MCP Tools