Codecov

Queries Codecov coverage data for files, commits, and repositories via an MCP interface supporting both cloud and self-hosted Codecov.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "egulatee-mcp-server-codecov": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-codecov"
      ],
      "env": {
        "CODECOV_TOKEN": "YOUR_API_TOKEN",
        "CODECOV_BASE_URL": "https://codecov.io"
      }
    }
  }
}

You can query Codecov coverage data using a dedicated MCP server that connects to either codecov.io or a self-hosted Codecov instance. This MCP server exposes tools to fetch file-level, commit-level, and repository-wide coverage, enabling seamless integration with your MCP-enabled clients.

How to use

Use the MCP server with your MCP client to retrieve coverage data from Codecov. You can request file-level coverage for a specific file, fetch coverage for a particular commit, or obtain overall repository coverage. These tools are designed to work with both public Codecov and self-hosted Codecov instances by configuring the base URL and providing an API token.

How to install

Prerequisites you need before installing include Node.js and npm installed on your machine.

Option A: Install the MCP server globally with npm.

npm install -g mcp-server-codecov

Verify the installation and locate the executable.

npm list -g mcp-server-codecov
which mcp-server-codecov
npm view mcp-server-codecov version

Additional configuration and runtime

You typically run the MCP server via an MCP client by configuring a stdio transport. The following configuration shows how to start the Codecov MCP server with the required environment variables and the runtime command.

claude mcp add --transport stdio codecov \
  --env CODECOV_BASE_URL=https://codecov.io \
  --env CODECOV_TOKEN=${CODECOV_TOKEN} \
  -- npx -y mcp-server-codecov

Usage overview

The MCP server exposes the following tools to query Codecov data: get_file_coverage, get_commit_coverage, and get_repo_coverage. Use these tools from your MCP client to request coverage data for a specific file, a particular commit, or an entire repository.

Notes on tokens and URLs

Use an API token, not an upload token, to read coverage data from Codecov via the API. If you operate a self-hosted Codecov instance, set CODECOV_BASE_URL to the base URL of that instance and provide the corresponding API token.

Available tools

get_file_coverage

Get line-by-line coverage data for a specific file within a repository, returning coverage details for each line.

get_commit_coverage

Get coverage data for a specific commit by its SHA, providing the coverage statistics for that commit.

get_repo_coverage

Get overall coverage statistics for a repository, optionally scoped to a specific branch.