Skip to main content

UltimateCoder MCP - Local-first automation server for developers and engineers

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 5d00dae4f259e8d45a99901cf7c4673d18c1ccb8c8d9e2c0b5e1b36eada8e968
MD5 b45a6d7c4b1b4ea8f89df995cdce66c3
BLAKE2b-256 f182775973549af3e7441cb462c4081cb9ac02cce691493d82e18940b2f67bf4

See more details on using hashes here.

File details

Details for the file iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 18.0 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for iflow_mcp_m_ahmed_elbeskeri_ultimatecodermcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b6f547f274c928932113e35c775f5ee291bc74d8af5def8a6bfa2f95c1cbab5e
MD5 2fbec9cf1dbff12047628e3365c1dc53
BLAKE2b-256 39b27bc1a1304b0962015829f605d38f4cee42a196a7c964cb2fe7b97f3704c9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page