Skip to main content

UltimateCoder MCP

Local-first automation server for developers and engineers — automate terminal commands, edit files, and power up your AI tools.

Buy Me a Coffee Smithery Downloads Stars

Smithery link: https://smithery.ai/server/@m-ahmed-elbeskeri/ultimatecodermcp

UltimateCoder turns your local machine into a surgical code command center.
Built on fastmcp, UltimateCoder delivers total control over your filesystem, processes, and codebase — with AI-enhanced precision.

Run terminal commands, edit thousands of files at once, apply unified diffs safely, or let your AI assistant intelligently refactor your project.
All locally, instantly, and securely.

No cloud latency. No data leaving your machine. No compromises.

Built for builders. Loved by automation architects. Trusted by power users.

What Makes UltimateCoder Different

  • MCP-native, fully local server — AI assistants (like Claude) gain real-time read/write power over your projects.
  • Fast, Safe File Editing — Single lines, blocks, or entire files. Precise changes, full control.
  • Advanced Patch & Diff Engine — Unified diffs apply with strict context matching, so you never apply mistakes blindly.
  • Process Control — List, monitor, and kill running processes programmatically.
  • Supercharged Search — Ripgrep-backed recursive search with smart fallbacks.
  • Multi-file Operations — Process thousands of files across your codebase. Batch edits, mass linting, intelligent replacements.
  • Ready for Automation — Ideal for scripting, automation, and human-in-the-loop AI workflows.
  • Built on fastmcp — Lightning-fast, extensible MCP core.

What Can It Do

Feature Benefit Typical Use Case
Terminal Execution Run any local shell command with full output capture Automate build scripts, deploy, run tests, manage local tools
Process Management List and kill processes by PID Manage runaway processes, automate cleanup
File Operations Read, write, move, and delete files & directories Automate file handling tasks, backups, or migrations
File Metadata Retrieval Get size, timestamps, permissions Auditing, automation pipelines
Precise Line/Block Replacement Make targeted file edits (supports regex) Fix configuration files, update code snippets programmatically
Unified Diff Patching Safely apply diffs with strict context matching Automated refactoring, safe code migrations
Mass Code Search Ripgrep-powered search across files Explore codebases, find usages, audit security-sensitive patterns
JSON and Python Linting Instant feedback for common formats Validate configs, ensure code hygiene
Static Python Analysis Deeper pylint insights Spot bugs before they happen
Read Python with Line Numbers Contextual code review or AI-assisted editing AI understands context better, human reviews are faster
Batch File Processing Work on thousands of files at once Large-scale refactoring or analysis
AI-Enhanced Workflows Fully compatible with Claude Desktop and MCP clients Let your AI assistant become a local dev co-pilot

Example Use Cases

  • Refactor 10,000+ files safely using unified diff patches with context validation.
  • Audit your entire project for deprecated functions in seconds.
  • Automate cleanup: list, analyze, and kill idle processes from batch scripts.
  • Enhance your AI workflows: give Claude or custom MCP clients real filesystem and terminal power.
  • Work on sensitive codebases: UltimateCoder runs 100% locally, no data leaves your machine.
  • Automate migrations: JSON schemas, Python packages, configs — all editable programmatically.
  • Lint and validate at scale: automate linting pipelines before commits or deployments.

Installation

Requirements

  • Python 3.8+
  • Core dependency: fastmcp

Steps

git clone https://github.com/m-ahmed-elbeskeri/UltimateCoderMCP.git
cd UltimateCoder
python main.py

You now have a fully operational MCP server running locally.

Tool Reference

Tool Summary
tool_run_command Execute local shell commands
tool_list_processes List system processes
tool_kill_process Kill a process by PID
tool_read_file Read file content (text or image)
tool_write_file Write/overwrite file content
tool_create_directory Make directories recursively
tool_list_files List files and folders (with recursion option)
tool_move_file Move or rename files/folders
tool_get_file_info Fetch metadata about a file
tool_replace_line Replace a specific line in a file
tool_replace_block Replace a text block (with optional regex)
tool_apply_patch Apply unified diff patches safely
tool_search_code Ripgrep-based recursive code search
tool_lint_json Validate JSON files
tool_lint_python Run flake8 linter on Python files
tool_static_analysis_python Static analysis with pylint
tool_read_multiple_files Batch-read multiple files
tool_process_files Async batch file processing
tool_search_files Pattern-based filename search
tool_search_replace Search and replace text in a file
tool_line_python_file Read Python file with line numbers for better context

Roadmap

  • Multi-language linting (JS, TS, CSS, Shell scripts)
  • Advanced multi-file diffing and patching
  • Smithery
  • CLI companion tool
  • Claude Desktop templates
  • Performance enhancements for enterprise-scale repositories

Contribute

We’re building UltimateCoder to be a developer-first, automation-friendly powerhouse.

  • Star the repo to support development
  • Open issues for bugs or ideas
  • Submit PRs to improve functionality
  • Share feedback and ideas in Discussions

Every contribution matters.

License

MIT License.
Use it, build on it, and make it your own.

Metadata

Release files for iflow-mcp_m-ahmed-elbeskeri-ultimatecodermcp 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_m-ahmed-elbeskeri-ultimatecodermcp 1.0.0
File Size Uploaded
iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0.tar.gz 17.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_m-ahmed-elbeskeri-ultimatecodermcp 1.0.0
File Interpreter ABI Platform
iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 35.8 kB

Release files / iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0.tar.gz

Download URL iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0.tar.gz
Size 17.7 kB
Tags Source
SHA-256 checksum
How to use checksums
5d00dae4f259e8d45a99901cf7c4673d18c1ccb8c8d9e2c0b5e1b36eada8e968
BLAKE2b-256 checksum
How to use checksums
f182775973549af3e7441cb462c4081cb9ac02cce691493d82e18940b2f67bf4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0-py3-none-any.whl

Download URL iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0-py3-none-any.whl
Size 18.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b6f547f274c928932113e35c775f5ee291bc74d8af5def8a6bfa2f95c1cbab5e
BLAKE2b-256 checksum
How to use checksums
39b27bc1a1304b0962015829f605d38f4cee42a196a7c964cb2fe7b97f3704c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page