MCP server
by myuon
Refactor enables regex-based code refactoring for bulk search-and-replace, pattern matching, and large-scale code transf
Performs regex-based search and replace operations across multiple files in your codebase. Helps automate large-scale code refactoring and migrations with pattern matching and context filtering.
Refactor is a community-built MCP server published by myuon that provides AI assistants with tools and capabilities via the Model Context Protocol. Refactor enables regex-based code refactoring for bulk search-and-replace, pattern matching, and large-scale code transf It is categorized under developer tools. This server exposes 2 tools that AI clients can invoke during conversations and coding sessions.
You can install Refactor in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
Refactor is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Add new capabilities to Claude beyond text generation
Example
Access external data sources, execute code, interact with tools and services
Transform Claude from chatbot to action-taking agent
Provide Claude with access to relevant context and data
Example
Load project documentation, access knowledge bases, query databases
Get more accurate, context-aware responses
Automate multi-step workflows combining AI and external tools
Example
Research → Summarize → Create document → Send notification
Complete complex tasks end-to-end without manual steps
Share your MCP server with the developer community
Refactor is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
Refactor has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
Strong directory entry: Refactor surfaces stars and publisher context so we could sanity-check maintenance before adopting.
Strong directory entry: Refactor surfaces stars and publisher context so we could sanity-check maintenance before adopting.
Refactor is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
Refactor is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
Refactor is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
Useful MCP listing: Refactor is the kind of server we cite when onboarding engineers to host + tool permissions.
Refactor reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
We wired Refactor into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
showing 1-10 of 36
A Model Context Protocol (MCP) server that provides powerful refactoring tools for Coding Agents. It can run in two modes:
This MCP server implements two main tools to assist with code refactoring:
Performs regex-based search and replace operations across files with advanced filtering capabilities.
Parameters:
search_pattern (string) - Regular expression pattern to search forreplace_pattern (string) - Replacement pattern (supports capture groups like $1, $2)context_pattern (string, optional) - Only replace matches within this contextfile_pattern (string, optional) - Glob pattern to limit files (e.g., *.js, src/**/*.ts)Example:
// Replace foo() calls with bar() calls
code_refactor("foo\((.+)\)", "bar($1)")
// Before: let k = foo(1,2,3);
// After: let k = bar(1,2,3);
Context-aware refactoring:
// Only replace "legacy_sdk" within import statements
code_refactor("legacy_sdk", "brand_new_sdk", "import")
Searches for regex patterns and returns file locations with precise line numbers.
Parameters:
search_pattern (string) - Regular expression pattern to search forcontext_pattern (string, optional) - Filter matches by surrounding contextfile_pattern (string, optional) - Glob pattern to limit search scopeExample:
code_search("foo\(.+\)")
// Result:
// ./src/utils.js (line: 15)
// ./src/helpers.ts (lines: 23-27)
MCP Server Mode (for Claude Code and other MCP clients):
# Install globally for MCP integration
npm install -g @myuon/refactor-mcp
# Or use with npx (recommended for MCP clients)
npx @myuon/refactor-mcp@latest
CLI Mode (for direct command-line usage):
# Search for patterns
npx @myuon/refactor-mcp@latest cli search -p "function.*\(" -f "src/**/*.js"
# Refactor with preview
npx @myuon/refactor-mcp@latest cli refactor -s "const (\w+)" -r "let \$1" --dry-run
# Clone and install dependencies
git clone https://github.com/myuon/refactor-mcp.git
cd refactor-mcp
npm install
You can use the refactor tools directly from the command line by adding cli after the main command:
# Search for patterns
refactor-mcp cli search -p "function (.*) \{" -f "src/**/*.ts"
# Search with matched content display
refactor-mcp cli search -p "function (.*) \{" -f "src/**/*.ts" --print
# Refactor with dry-run (preview changes)
refactor-mcp cli refactor -s "const (\w+) = " -r "let \$1 = " --dry-run
# Refactor with matched content display
refactor-mcp cli refactor -s "const (\w+) = " -r "let \$1 = " --print --dry-run
# Refactor with file pattern
refactor-mcp cli refactor -s "old_function" -r "new_function" -f "src/**/*.js"
# Context-aware refactoring
refactor-mcp cli refactor -s "legacy_sdk" -r "new_sdk" -c "import" -f "src/**/*.ts"
CLI Commands:
search - Search for code patterns
-p, --pattern <pattern> - Regular expression pattern to search for-c, --context <context> - Optional context pattern to filter matches-f, --files <files> - Optional file glob pattern to limit search scope--print - Print matched content to stdout--matched - Show only matched text with capture groupsrefactor - Refactor code with regex replacement
-s, --search <search> - Regular expression pattern to search for-r, --replace <replace> - Replacement pattern (supports $1, $2, etc.)-c, --context <context> - Optional context pattern to filter matches-f, --files <files> - Optional file glob pattern to limit search scope--dry-run - Preview changes without modifying files--print - Print matched content and replacements to stdoutImportant Notes:
\$1, \$2, etc.refactor-mcp cli refactor -s "const (\w+) = " -r "let \$1 = " --dry-run$1 as a shell variableBy default, refactor-mcp runs as an MCP server via stdio transport:
# Run as MCP server (default mode)
refactor-mcp
# Or explicitly with npx
npx @myuon/refactor-mcp@latest
npm run dev # Run server in development mode
npm run dev:cli # Run CLI in development mode with arguments
npm run cli # Run CLI directly (for testing)
npm run build # Build for production
npm start # Run built server (MCP mode)
npm run check # Run all quality checks
npm run lint # Run ESLint
npm run format # Format code with Prettier
npm test # Run tests
This server uses the Model Context Protocol to communicate with compatible clients. It runs via stdio transport and can be integrated into any MCP-compatible environment.
For Claude Code users, you can easily add this MCP server with:
claude mcp add refactor npx @myuon/refactor-mcp@latest
Add to your MCP client configuration:
{
"mcpServers": {
"refactor-mcp": {
"command": "npx",
"args": ["@myuon/refactor-mcp@latest"]
}
}
}
{
"mcpServers": {
"refactor-mcp": {
"command": "refactor-mcp"
}
}
}
npm installnpm testnpm run checknpm run buildMIT
Prerequisites
Time Estimate
15-60 minutes depending on server complexity
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
Model Context Protocol standardizes how AI hosts (Claude, Cursor) communicate with external tools and data sources through server implementations.
Protocols
Compatibility
✓ Use when
Use when you need Claude to access external data, execute actions, or integrate with tools. Best for extending AI capabilities beyond conversation.
✗ Avoid when
Avoid when native integrations exist (use official APIs directly), for real-time critical systems, or when security/compliance requires zero external dependencies.