cargo-mcp

Cargo MCP Server

Caution

This repository is written by AI as an experiment. Although I (jbr) review every line, the code quality is not necessarily identical to what I would have written. Caveat usor.

A Model Context Protocol (MCP) server that provides safe access to Cargo operations for Rust projects.

Features

This MCP server exposes the following Cargo tools:

cargo_check - Verify code compiles without producing executables
cargo_clippy - Run the Clippy linter for code suggestions
cargo_test - Execute project tests
cargo_fmt_check - Check code formatting without modifying files
cargo_build - Build the project (debug or release mode)
cargo_bench - Run benchmarks
cargo_add - Add dependencies to Cargo.toml
cargo_remove - Remove dependencies from Cargo.toml
cargo_update - Update dependencies
cargo_clean - Remove artifacts that cargo has generated in the past

All tools support setting custom environment variables via the cargo_env parameter and rust toolchain with the toolchain parameter.

Installation

cargo install cargo-mcp

Usage with Claude Desktop

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "cargo-mcp": {
      "command": "/path/to/cargo-mcp/cargo-mcp",
      "args": ["serve"]
    }
  }
}

Optionally, include --default-toolchain TOOLCHAIN in the arguments, where TOOLCHAIN is something like "stable" or "nightly".

Tool Usage

All tools accept an optional cargo_env parameter to set environment variables for the cargo command:

{
  "cargo_env": {
    "CARGO_LOG": "debug",
    "RUSTFLAGS": "-C target-cpu=native",
    "CARGO_TARGET_DIR": "/tmp/my-target"
  }
}

cargo_check

Verify that your Rust code compiles:

{
  "name": "cargo_check",
  "arguments": {
    "path": "/path/to/rust/project",
    "package": "optional-package-name",
    "cargo_env": {
      "CARGO_LOG": "debug"
    }
  }
}

cargo_clippy

Get linting suggestions:

{
  "name": "cargo_clippy", 
  "arguments": {
    "path": "/path/to/rust/project",
    "package": "optional-package-name",
    "fix": false,
    "cargo_env": {
      "RUSTFLAGS": "-D warnings"
    }
  }
}

cargo_test

Run tests:

{
  "name": "cargo_test",
  "arguments": {
    "path": "/path/to/rust/project", 
    "package": "optional-package-name",
    "test_name": "optional-specific-test",
    "cargo_env": {
      "RUST_TEST_THREADS": "1"
    }
  }
}

cargo_fmt_check

Check formatting:

{
  "name": "cargo_fmt_check",
  "arguments": {
    "path": "/path/to/rust/project",
    "cargo_env": {
      "CARGO_LOG": "info"
    }
  }
}

cargo_build

Build the project:

{
  "name": "cargo_build",
  "arguments": {
    "path": "/path/to/rust/project",
    "package": "optional-package-name", 
    "release": false,
    "cargo_env": {
      "RUSTFLAGS": "-C target-cpu=native"
    }
  }
}

cargo_bench

Run benchmarks:

{
  "name": "cargo_bench",
  "arguments": {
    "path": "/path/to/rust/project",
    "package": "optional-package-name",
    "bench_name": "optional-specific-benchmark",
    "baseline": "optional-baseline-name",
    "cargo_env": {
      "CARGO_LOG": "debug"
    }
  }
}

cargo_add

Add dependencies:

{
  "name": "cargo_add",
  "arguments": {
    "path": "/path/to/rust/project",
    "dependencies": ["serde", "tokio@1.0"],
    "dev": false,
    "optional": false,
    "features": ["derive"],
    "cargo_env": {
      "CARGO_LOG": "info"
    }
  }
}

cargo_remove

Remove dependencies:

{
  "name": "cargo_remove",
  "arguments": {
    "path": "/path/to/rust/project",
    "dependencies": ["unused-dep"],
    "dev": false,
    "cargo_env": {
      "CARGO_LOG": "info"
    }
  }
}

cargo_update

Update dependencies:

{
  "name": "cargo_update",
  "arguments": {
    "path": "/path/to/rust/project",
    "package": "optional-package-name",
    "dependencies": ["specific-dep-to-update"],
    "dry_run": false,
    "cargo_env": {
      "CARGO_LOG": "debug"
    }
  }
}

cargo_clean

Update dependencies:

{
  "name": "cargo_clean",
  "arguments": {
    "path": "/path/to/rust/project",
    "package": "optional-package-name",
    "cargo_env": {
      "CARGO_LOG": "debug"
    }
  }
}

Environment Variables

The cargo_env parameter allows you to set environment variables that will be passed to the cargo command. Common useful environment variables include:

CARGO_LOG - Set logging level (trace, debug, info, warn, error)
RUSTFLAGS - Pass flags to the Rust compiler (e.g., -C target-cpu=native)
CARGO_TARGET_DIR - Override the target directory for build artifacts
RUST_TEST_THREADS - Control test parallelism
CARGO_INCREMENTAL - Enable/disable incremental compilation

Safety Features

Only whitelisted Cargo commands are available
Path validation ensures the target is a valid Rust project (has Cargo.toml)
No arbitrary command execution
All commands run in the specified project directory

License

MIT or APACHE-2.0

cargo-mcp

Cargo MCP Server

Features

Installation

Usage with Claude Desktop

Tool Usage

cargo_check

cargo_clippy

cargo_test

cargo_fmt_check

cargo_build

cargo_bench

cargo_add

cargo_remove

cargo_update

cargo_clean

Environment Variables

Safety Features

License

Related MCP Servers

mcp-server-docker

MarineTraffic MCP Server

modbus-mcp

argocd-mcpofficial

New MCP Servers

MCP directory API