@mrxkun/mcfast-mcp 3.3.7 → 3.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +37 -8
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -22,7 +22,7 @@ Standard AI agents often struggle with multi-file edits, broken syntax, and "hal
22
22
 
23
23
  ---
24
24
 
25
- ## 🚀 Key Features (v3.3)
25
+ ## 🚀 Key Features (v3.4)
26
26
 
27
27
  ### 1. **AST-Aware Refactoring**
28
28
  mcfast doesn't just "search and replace" text. It parses your code into a Tree-sitter AST to perform:
@@ -102,15 +102,44 @@ Add the following to your `claude_desktop_config.json`:
102
102
 
103
103
  ---
104
104
 
105
- ## 🧰 Available Tools
105
+ ## 🧰 5 Unified Tools
106
106
 
107
- mcfast exposes a unified set of tools to your AI agent:
107
+ mcfast exposes a complete set of 5 tools to your AI agent, each optimized for specific use cases:
108
108
 
109
- * **`edit`**: The primary tool. It decides whether to use `ast_refactor`, `fuzzy_patch`, or `search_replace` based on the task complexity.
110
- * **`search`**: Fast grep-style search with in-memory AST indexing.
111
- * **`read`**: Smart reader that returns code chunks with line numbers, optimized for token savings.
112
- * **`list_files`**: High-performance globbing with `.gitignore` support and context-aware filtering.
113
- * **`reapply`**: If an edit fails validation, the AI can use this to retry with a different strategy.
109
+ | Tool | Purpose | Best For |
110
+ |------|---------|----------|
111
+ | **`edit`** | Multi-file code editing | Complex refactoring, renaming, multi-file updates |
112
+ | **`search`** | Fast pattern search | Finding code patterns, symbols, references |
113
+ | **`read`** | Read file content | Viewing specific files with line ranges |
114
+ | **`list_files`** | Directory exploration | Discovering project structure, finding files |
115
+ | **`reapply`** | Retry failed edits | Auto-recovery with enhanced context |
116
+
117
+ ### Tool Details
118
+
119
+ **`edit`** (aliases: `apply_fast`, `edit_file`, `apply_search_replace`)
120
+ - Primary editing tool with auto-strategy detection
121
+ - Supports: AST refactoring, fuzzy patching, search-replace
122
+ - Handles single-file and multi-file edits seamlessly
123
+
124
+ **`search`** (aliases: `search_code`, `search_code_ai`)
125
+ - Fast pattern matching with regex support
126
+ - In-memory AST indexing for symbol-aware searches
127
+ - Automatic junk directory filtering (node_modules, .git, dist, etc.)
128
+
129
+ **`read`** (alias: `read_file`)
130
+ - Read file content with optional line ranges
131
+ - Optimized for token efficiency (read only what you need)
132
+ - Supports all 10 language parsers
133
+
134
+ **`list_files`** (alias: `list_files_fast`)
135
+ - Recursive directory listing with depth control
136
+ - Respects `.gitignore` automatically
137
+ - Perfect for exploring codebase structure
138
+
139
+ **`reapply`**
140
+ - Smart retry mechanism for failed edits
141
+ - Enhanced context and error analysis
142
+ - Max 3 automatic retries with strategy adjustment
114
143
 
115
144
  ---
116
145
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mrxkun/mcfast-mcp",
3
- "version": "3.3.7",
4
- "description": "Ultra-fast code editing with fuzzy patching, auto-rollback, and 5 unified tools.",
3
+ "version": "3.4.1",
4
+ "description": "Ultra-fast code editing with fuzzy patching, auto-rollback, and 7 unified tools.",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "mcfast-mcp": "src/index.js"