MCP server for the Codecov API v2 over stdio or Streamable HTTP. Exposes three read tools so agents can check coverage totals, list files with misses, and inspect a single file report.
Canonical repo: Interchouette-ITC/codecov-rust-mcp.
Service is fixed to GitHub (github in the Codecov API path).
| Doc | Description |
|---|---|
OVERVIEW.md |
Product overview and layout |
mcp.md |
Operator guide: tools, auth, env, Make, MCP clients |
CONTRIBUTING.md |
PR habits and local gates |
CODE_OF_CONDUCT.md |
Contributor Covenant |
SECURITY.md |
Vulnerability reporting |
pull_request_template.md |
PR Summary + Test plan |
| Rust API (rustdoc) | Generated by make doc; published from dev via GitHub Pages |
LICENSE |
Apache-2.0 |
| Tool | Purpose |
|---|---|
codecov_totals |
Commit coverage totals for a GitHub owner / repo (optional branch or sha) |
codecov_miss_files |
Commit totals + files with misses > 0 (sorted desc) + returned count (limit default 30; 0 = uncapped) |
codecov_file_report |
Line coverage for one repository-relative path |
cargo +stable install --path . --force
mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/codecov-rust-mcp"
cp .env.example "${XDG_CONFIG_HOME:-$HOME/.config}/codecov-rust-mcp/.env"
# edit that file: set CODECOV_TOKEN (Access token, not upload token)Point any MCP-capable agent or IDE at mcp.json.example: run codecov-rust-mcp on PATH. Token stays in user config .env (or process env), not in the MCP host JSON.
Prebuilt Linux binary: GitHub Releases (codecov-rust-mcp-*-x86_64-unknown-linux-gnu).
Docker image: interchouette/codecov-rust-mcp (Streamable HTTP on :8690 /mcp by default). Hub Overview source: docker/DOCKERHUB.md.
Thanks to GitHub for hosting and Actions, and to Codecov for coverage reports and the API this server wraps.
Apache-2.0 (Apache License, Version 2.0). See LICENSE.