Codecov Mcp
What is Codecov Mcp
Codecov MCP is a server that implements the Codecov Model Context Protocol, designed to help developers identify areas in their codebase that lack sufficient test coverage.
Use cases
Use cases for codecov-mcp include analyzing code coverage for specific commits, generating suggestions for additional tests to improve coverage, and integrating with AI tools to enhance testing strategies.
How to use
To use codecov-mcp, run the command ‘npx -y codecov-mcp-server --api-key XXX --git-url XXX’ in your terminal, replacing ‘XXX’ with your Codecov API key and Git URL. You can also configure it to work with AI agents by adding the server configuration in JSON format.
Key features
Key features include the ‘get_commit_coverage_totals’ tool, which retrieves coverage totals for specific commits, and the ‘suggest_tests’ prompt that recommends tests to write based on the Codecov report.
Where to use
Codecov MCP can be used in software development environments where code quality and test coverage are critical, particularly in teams that utilize continuous integration and delivery practices.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Codecov Mcp
Codecov MCP is a server that implements the Codecov Model Context Protocol, designed to help developers identify areas in their codebase that lack sufficient test coverage.
Use cases
Use cases for codecov-mcp include analyzing code coverage for specific commits, generating suggestions for additional tests to improve coverage, and integrating with AI tools to enhance testing strategies.
How to use
To use codecov-mcp, run the command ‘npx -y codecov-mcp-server --api-key XXX --git-url XXX’ in your terminal, replacing ‘XXX’ with your Codecov API key and Git URL. You can also configure it to work with AI agents by adding the server configuration in JSON format.
Key features
Key features include the ‘get_commit_coverage_totals’ tool, which retrieves coverage totals for specific commits, and the ‘suggest_tests’ prompt that recommends tests to write based on the Codecov report.
Where to use
Codecov MCP can be used in software development environments where code quality and test coverage are critical, particularly in teams that utilize continuous integration and delivery practices.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Codecov MCP Server
A Codecov Model Context Protocol server in TypeScript.
- Tools for finding where your codebase is lacking tests.
- Prompts for suggesting which tests to write.
Features
Resources
- None yet
Tools
get_commit_coverage_totals- Returns the coverage totals for a given commit and the
coverage totals broken down by file. Uses this api.
Prompts
suggest_tests- Suggests tests to write based on Codecov report.
Installation
Usage: Ask your AI agent to “run the get_commit_coverage_totals tool” in your chat.
Configure: No need to install anything, just run with npx and put in your Codecov API key from here - Go to Settings -> Access.
And git url: git remote get-url origin
Cursor command: npx -y codecov-mcp-server --api-key XXX --git-url XXX
(On Windows) Cursor command: cmd.exe /c npx -y codecov-mcp-server --api-key XXX --git-url XXX
To use with Claude (or any AI), add the server config:
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
