Back to Browse

Agz Rust MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Bounded, source-write-free Rust correctness tools grounded in Cargo and rustc output.

About

Bounded, source-write-free Rust correctness tools grounded in Cargo and rustc output.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

14 files analyzed · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

Documentation

View on GitHub

From the project's GitHub README.

AGZ Rust MCP

CI crates.io License: MIT

English | Türkçe

An AGZ Yazılım product. agz-rust-mcp is a standalone stdio MCP server for bounded Rust correctness grounded in Cargo and rustc. It runs bounded Cargo validation, audits source, resolves exact-version crate documentation, provides Rust Analyzer navigation, and returns write-free rename/refactor packages.

Install

# installer script (Linux x86_64): download install.sh and SHA256SUMS from the
# latest release, verify the script, then run it
bash install.sh

# crates.io (requires Rust 1.88.0 or newer)
cargo install agz-rust-mcp --locked
agz-rust-mcp --version

Prebuilt .tar.gz archives with .sha256 files are available for Linux x86_64, macOS arm64, and Windows x86_64. Releases up to 0.2.0 use the legacy agz-rust-coder-* asset names; from 0.3.0 onward the names are agz-rust-mcp-*.

Step-by-step instructions, per-OS notes, checksum verification, and troubleshooting: docs/install.md · Türkçe.

MCP Client Setup

The current source also bundles four offline skills: agz-rust-workflow, agz-rust-repair, agz-rust-refactor, and agz-rust-performance. One executable serves the tools and their workflows through MCP prompts/resources; a second MCP is unnecessary. Filesystem-based clients can use agz-rust-mcp skills export. See bundled skills. Bundled skills are available from 0.4.0; 0.3.0 binaries do not include them.

ClientConfigurationGuide
ZCode~/.zcode/cli/config.json → mcp.servers.rustZCode
OpenCodeopencode.jsonc → mcp.rustOpenCode
OpenCode2opencode.jsonc → mcp.servers.rustOpenCode2
Codex~/.codex/config.toml → mcp_servers.rustCodex

Use the example for your client; OpenCode and OpenCode2 have different layouts. All launch the installed agz-rust-mcp binary. Run agz-rust-mcp --version once before connecting, and use an absolute path if the client's PATH differs.

The canonical current directory is the default authorized root. Add explicit roots with repeated --allow-root arguments when the client starts elsewhere; client-provided MCP roots may narrow configured access but never widen it. See docs/install.md for per-client setup.

Documentation

Read the documentation in this order:

  1. Install and client setup - every install method and client configuration.
  2. Tool and configuration reference - tools, actions, result semantics, and all configuration keys.
  3. Architecture - process model, protocol lifecycle, and authority boundaries.
  4. Validation and benchmark protocol - smokes, gates, and evidence.
  5. Security policy and Contributing.

The bilingual index with the full reading path is docs/README.md / docs/README.tr.md.

Identity

ContractValue
Crate, binary, serveragz-rust-mcp
MCP Registryio.github.ugur-murat-alt/agz-rust-mcp
Source version0.4.0
First release0.1.0
Release tagagz-rust-mcp-v<version>
Rust edition / MSRV2024 / 1.88.0
Rust MCP SDKrmcp 3.1.4
Default / discovered protocol2025-11-25 / 2026-07-28

MCP package ownership marker: mcp-name: io.github.ugur-murat-alt/agz-rust-mcp.

Tools

OpenCode2 commonly exposes grouped MCP tools as rust_*.

MCP toolOpenCode2 direct nameDefaultPurpose
checkrust_checkenabledRun bounded Cargo check, Clippy, tests, docs, or the full gate.
profilerust_profileenabledAnalyze observed Cargo rebuild behavior and compare bounded build evidence without claiming unmeasured speedups.
auditrust_auditenabledScan Rust source for bounded static findings.
crate_lookuprust_crate_lookupenabledVerify a crate and optional exact version on crates.io.
docsrust_docsenabledResolve exact-version docs from cache, local sources, or docs.rs.
contextrust_contextenabledPrepare, expand, or delta a revision-bound semantic context capsule with per-item reasons.
apirust_apienabledResolve an API signature from bounded analyzer evidence or type-check a candidate snippet in an isolated copy of the workspace configuration.
explainrust_explainenabledExplain macro expansion provenance, trait obligations, or cfg enablement.
verifyrust_verifyenabledPlan or run a bounded feature, target, toolchain, and stage matrix.
symbolrust_symbolenabledRead Rust Analyzer hover data for one symbol.
referencesrust_referencesenabledFind bounded references.
definitionrust_definitionenabledFind the selected definition.
symbolsrust_symbolsenabledList symbols in one Rust file.
implementationsrust_implementationsenabledFind implementations.
hierarchyrust_hierarchyenabledTrace a bounded call hierarchy.
renamerust_renameenabledProduce a verified rename edit package without applying it.
refactorrust_refactorenabledProduce a verified refactor edit package without applying it.
changerust_changeenabledCreate, stage, migrate, and validate a revision-bound changeset in server-owned scratch without writing the workspace.
repairrust_repairenabledAnalyze, try, compare, and minimize compiler-driven repair candidates for a failing change revision without writing the workspace.
workrust_workenabledDrive a typed intent through change/validate with explicit gates and budgets, returning honest gate evidence or a bounded single-use handoff.

Every tool returns deterministic structured data plus an equivalent bounded text fallback. External data stays under untrustedData. Expected domain outcomes such as compiler failure, missing crates, or unavailable docs are typed results; invalid input, authorization failure, resource exhaustion, and unavailable semantic infrastructure are protocol errors.

Configuration

Precedence is CLI, then AGZ_RUST_MCP_* environment variables, then the explicit --config TOML file, then defaults. Environment keys use __ between sections, for example AGZ_RUST_MCP_GATE__HARD_TIMEOUT_MS=600000.

KeyDefaultMeaning
server.allow_rootscanonical CWDWorkspace read/command boundary.
server.allow_dependency_rootsemptyExplicit external path-dependency roots.
gate.hard_timeout_ms600000Cargo operation deadline.
gate.scopeshadowValidation target: workspace, shadow, or affected.
gate.cacheautoCache policy: auto, project, or isolated.
rust_analyzer.workspace_codedenyReject RA startup unless workspace code is disabled.
docs.fallbackautoDocumentation source policy.
profile.max_report_bytes4194304Bounded read/store cap for one Cargo timing artifact.
profile.max_runs4Fresh Cargo runs available to one profile call.
profile.compare_samples3Required samples per side before any speed claim.
limits.tool_output_bytes49152Maximum serialized tool result size.
change.max_bytes268435456Maximum captured candidate bytes per changeset.
repair.max_candidates4Candidates one repair action may try.
repair.max_compiles4Cargo validations one repair action may run.
repair.wall_time_ms120000Wall-clock budget for one repair action.
repair.minimize_max_candidates32Compile-evaluated reduction attempts one repair(action=minimize) may try.
repair.minimize_max_compiles16Cargo runs one repair(action=minimize) may execute, including reproduction and export verification.
work.max_candidates4Host candidate revisions one work item may stage.
work.max_compiles12Gate validations one work item may run.
work.wall_time_ms600000Wall-time budget for one work item.
telemetry.enabledtrueBounded local activity records without prompts or source.

profile evidence is bounded: the latest 64 records stay in memory, and persisted timing artifacts under the server-owned profile-evidence directory are pruned after 24 hours or beyond 64 files. The profile result reports this retention policy, so expired evidence is visible instead of silently reused.

Run agz-rust-mcp --help for every CLI field. The complete behavior and default table is in docs/tools.md.

Security

The server does not modify workspace source, but it is not an operating-system sandbox. Cargo build scripts, tests, procedural macros, local rustdoc, and opted-in Rust Analyzer workspace code execute with the server user's authority. Use a container or OS sandbox when that boundary is required. Workspace, dependency, cache, lease, journal, docs, and telemetry paths are canonicalized, bounded, and fail closed, and stdout is reserved for MCP framing. Report vulnerabilities privately as described in SECURITY.md.

Links

License

MIT, Copyright (c) 2026 Ugur Murat Altintas.

Reviews

No reviews yet

Be the first to review this server!