fossil

Fossil MCP is a static analysis toolkit exposed as an MCP server. It focuses on identifying dead code, code clones, scaffolding artifacts like Phase/TODO markers, and temporary files across multi-language codebases. As an MCP server, Fossil provides a code-graph oriented view for AI agents so they can reason about function call relationships, blast radii of changes, and cross-file dead code without scanning every file manually. Developers and AI agents can query the server to surface potential issues and navigate code paths efficiently, rather than relying on text search alone. When running in server mode, Fossil can be consumed by editor plugins or AI tooling to augment code review and autonomous refactoring workflows with graph-based insights and targeted warnings.

To use Fossil, start the MCP server (the binary is fossil-mcp after installation). The server will expose endpoints that accept code graphs, analysis requests, and configuration toggles. Integrations can request: dead code candidates, cross-file references, call graphs, and scaffold/temporary artifact detections. Use the provided tooling to fetch results for a given project, then feed those results to your AI agent to steer refactoring and cleanup efforts with a clear view of dependencies and call paths.

Prerequisites:\n- A supported development environment (Linux, macOS, or Windows)\n- Rust toolchain (rustup) installed if you choose to build from source or use cargo install.\n- Internet access to download binaries or crates.\n\nOption A: Install via pre-built binaries (recommended)\n1) Visit the Fossil MCP releases page and download the latest fossil-mcp binary for your platform.\n2) Move the binary to a directory in your PATH, for example:\n\n # macOS/Linux:\n mv fossil-mcp /usr/local/bin/\n # Windows (PowerShell):\n Move-Item fossil-mcp.exe -Destination C:\Tools\fossil-mcp\fossil-mcp.exe\n\n3) Ensure it is executable: chmod +x fossil-mcp (Linux/macOS).\n4) Run the MCP server (see usage docs for endpoints).\n\nOption B: Install via Cargo (build from source or install pre-built)\n1) Ensure Rust toolchain is installed (https://rust-lang.org).\n2) Install the Fossil MCP binary via cargo:\n\n cargo install fossil-mcp\n\n3) Ensure the installed binary is in your PATH. The command will typically be fossil-mcp.\n\nOption C: Build from source\n1) Clone the repo:\n\n git clone https://github.com/yfedoseev/fossil-mcp.git\n cd fossil-mcp\n\n2) Build the binary with cargo:\n\n cargo build --release\n\n3) Run the produced binary from target/release/fossil-mcp or move it into your PATH.

Notes and tips:\n- Fossil detects multiple kinds of artifacts across languages; results may require tuning to your codebase.\n- The MCP server mode is designed for AI agents so that toolchains can query a graph rather than perform blanket searches. Ensure your integration passes the appropriate codebase and language context.\n- If you upgrade Fossil, you may need to reinitialize or migrate configuration; check release notes for breaking changes.\n- Environment variable placeholders can be filled with project-specific settings (e.g., endpoints, authentication tokens for private repos, or language-specific analysis toggles).\n- If you encounter network or startup issues, verify the binary is in PATH, confirm the port the server binds to, and check for required permissions on the host system.