A Codecov Model Context Protocol server in TypeScript.
- Tools for finding where your codebase is lacking tests.
- Prompts for suggesting which tests to write.
- None yet
get_commit_coverage_totals- Returns the coverage totals for a given commit and the coverage totals broken down by file. Uses this api.
suggest_tests- Suggests tests to write based on Codecov report.
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:
{
"mcpServers": {
"codecov-mcp-server": {
"command": "npx",
"args": [
"-y",
"codecov-mcp-server",
],
"env": {
"CODECOV_API_KEY": "XXX",
"GIT_URL": "XXX"
}
}
}
}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 inspectorThe Inspector will provide a URL to access debugging tools in your browser.
Install dependencies:
npm installBuild the server:
npm run buildFor development with auto-rebuild:
npm run watch