@morphllm/morphmcp 0.8.10 → 0.8.13

package/README.md

@@ -1,12 +1,12 @@
 # Morph MCP
 
-Unified Model Context Protocol (MCP) server providing AI-powered file editing and intelligent code search capabilities.
+Unified Model Context Protocol (MCP) server providing AI-powered file editing and intelligent code search capabilities. Built on Morph's SDK for fast, accurate code operations.
 
 ## Features
 
 ### AI-Powered Tools
-- **Fast Apply (edit_file)** - Morph's lightning-fast code editing at 4500+ tokens/sec with 99.2% accuracy
-- **Fast Context Search (fast_context_search)** - AI-powered code search that intelligently explores repositories to find relevant code
+- **Fast Apply (edit_file)** - Morph's lightning-fast code editing at 10,500+ tokens/sec with 98% accuracy
+- **Fast Context Search (fast_context_search)** - AI-powered code search using WarpGrep that intelligently explores repositories to find relevant code
 
 ### Filesystem Operations
 - Read/write files with memory-efficient head/tail operations
@@ -18,8 +18,9 @@ Unified Model Context Protocol (MCP) server providing AI-powered file editing an
 ### Security & Access Control
 - Dynamic directory access control via [MCP Roots](https://modelcontextprotocol.io/docs/concepts/roots)
 - Workspace-aware path resolution
-- Automatic workspace detection
+- Automatic workspace detection (enabled by default)
 - Atomic file operations with temp files for safety
+- Symlink protection and path validation
 
 ## Configuration
 
@@ -28,20 +29,23 @@ Unified Model Context Protocol (MCP) server providing AI-powered file editing an
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `MORPH_API_KEY` | Your Morph API key (required for AI tools) | - |
-| `ENABLED_TOOLS` | Comma-separated list of enabled tools, or `all` | `all` |
+| `ENABLED_TOOLS` | Comma-separated list of enabled tools, or `all` | `edit_file,fast_context_search` |
 | `MORPH_DEBUG` | Enable debug logging for grep agent (`true`/`false`) | `false` |
 | `ENABLE_WORKSPACE_MODE` | Auto-detect workspace root (`true`/`false`) | `true` |
 | `WORKSPACE_ROOT` | Override workspace root directory | `$PWD` |
 
 ### Tool Configuration
 
-Control which tools are available using `ENABLED_TOOLS`:
+Control which tools are available using `ENABLED_TOOLS`. **By default, only AI-powered tools (`edit_file` and `fast_context_search`) are enabled** to keep the interface clean. Enable additional filesystem tools as needed:
 
 ```bash
-# Enable all tools (default)
+# Default: Only AI-powered tools
+# (No ENABLED_TOOLS needed - edit_file and fast_context_search are enabled by default)
+
+# Enable all tools including filesystem operations
 ENABLED_TOOLS=all
 
-# Only AI-powered tools
+# Only AI-powered tools (explicit, same as default)
 ENABLED_TOOLS=edit_file,fast_context_search
 
 # Only fast apply
@@ -59,18 +63,28 @@ ENABLED_TOOLS=read_file,write_file,edit_file,fast_context_search
 ### AI-Powered Tools
 
 #### `edit_file`
-**PRIMARY TOOL FOR EDITING FILES** - Efficiently edit existing files by smartly showing only changed lines. Uses Morph's fast apply model for intelligent code merging.
+**PRIMARY TOOL FOR EDITING FILES** - Efficiently edit existing files by smartly showing only changed lines. Uses Morph's Fast Apply model (via `@morphllm/morphsdk`) for intelligent code merging.
 
 **Key features:**
-- 4500+ tokens/sec with 99.2% accuracy
+- 10,500+ tokens/sec with 98% accuracy
+- Prevents context pollution by only showing changed lines
 - Smart context preservation with `// ... existing code ...`
 - Batch multiple edits to the same file
-- Git-style diff output
+- Git-style unified diff output
+- Automatic error reporting to Morph for continuous improvement
 
 **Requires:** `MORPH_API_KEY`
 
+**Note for Cursor users:** If you're using this tool within Cursor, you may need to first use another tool (like `search_replace`) to add exactly one empty newline somewhere in the file before using `edit_file`. This ensures the file is in an editable state.
+
 #### `fast_context_search`
-Intelligently search and gather relevant code context from a repository using an AI-powered search agent. Automatically explores the codebase with grep, file reading, and directory analysis.
+Intelligently search and gather relevant code context from a repository using Morph's WarpGrep AI-powered search agent. Automatically explores the codebase with grep, file reading, and directory analysis to find exactly what you need.
+
+**Key features:**
+- AI-powered multi-round exploration
+- Returns precise line ranges, not entire files
+- Prevents context pollution by finding only relevant code
+- Formatted XML output with line numbers
 
 **Example queries:**
 - "Where is JWT token validation implemented?"
@@ -80,12 +94,16 @@ Intelligently search and gather relevant code context from a repository using an
 **Requires:** `MORPH_API_KEY`
 
 ### File Operations
-- `read_file` - Read complete file contents with optional head/tail
+*Note: These tools are available but disabled by default. Set `ENABLED_TOOLS=all` to enable.*
+
+- `read_file` - Read complete file contents with optional head/tail (memory-efficient for large files)
 - `read_multiple_files` - Read multiple files simultaneously
-- `write_file` - Create or overwrite files
+- `write_file` - Create or overwrite files with atomic writes
 - `tiny_edit_file` - Make small line-based edits with diff output
 
 ### Directory Operations
+*Note: These tools are available but disabled by default. Set `ENABLED_TOOLS=all` to enable.*
+
 - `create_directory` - Create directories recursively
 - `list_directory` - List directory contents
 - `list_directory_with_sizes` - List with file sizes and sorting
@@ -93,6 +111,8 @@ Intelligently search and gather relevant code context from a repository using an
 - `move_file` - Move/rename files and directories
 
 ### Search & Info
+*Note: These tools are available but disabled by default. Set `ENABLED_TOOLS=all` to enable.*
+
 - `search_files` - Recursively search with exclude patterns
 - `get_file_info` - Get detailed file metadata
 - `list_allowed_directories` - Show accessible directories
@@ -218,7 +238,7 @@ Or manually add to `.vscode/mcp.json`:
 }
 ```
 
-**For everything (recommended):**
+**For everything (including all filesystem tools):**
 ```json
 {
   "env": {
@@ -228,6 +248,16 @@ Or manually add to `.vscode/mcp.json`:
 }
 ```
 
+**Default (AI tools only - recommended for most use cases):**
+```json
+{
+  "env": {
+    "MORPH_API_KEY": "sk-..."
+    // ENABLED_TOOLS defaults to edit_file,fast_context_search
+  }
+}
+```
+
 ### 3. Test Your Setup
 
 In your AI assistant, try:
@@ -242,10 +272,11 @@ In your AI assistant, try:
 Ask AI: "Use the edit_file tool to add error handling to this function"
 
 The AI will:
-1. Read the current code
+1. Read the current code (or use existing context)
 2. Generate smart edit instructions with "// ... existing code ..."
-3. Apply changes at 4500+ tokens/sec
-4. Show you a git-style diff
+3. Apply changes at 10,500+ tokens/sec using Morph's Fast Apply
+4. Show you a git-style unified diff
+5. Report errors (if any) to Morph for continuous improvement
 ```
 
 ### Fast Context Search
@@ -253,11 +284,13 @@ The AI will:
 ```
 Ask AI: "Use fast_context_search to find where JWT tokens are validated"
 
-The agent will:
+The WarpGrep agent will:
 1. Explore the repository using grep, read, and analyse tools
-2. Find relevant code across multiple files
-3. Return precise line ranges with full context
-4. Display formatted XML output with line numbers
+2. Perform multi-round intelligent exploration
+3. Find relevant code across multiple files
+4. Return precise line ranges with full context (not entire files)
+5. Display formatted XML output with line numbers
+6. Show summary of tool calls made during search
 ```
 
 ## Migration Guide
@@ -312,37 +345,49 @@ The agent will:
 ```
 morph-mcp/
 ├── index.ts              # Main server & tool registry
-├── grep/                 # Fast context search agent
+├── grep/                 # Fast context search agent (WarpGrep)
 │   ├── agent/           # Multi-round exploration logic
 │   ├── tools/           # Grep, read, analyse, finish
 │   └── utils/           # Ripgrep, file finder, logger
-├── morph-client.ts      # Morph API integration
-└── path-*.ts            # Security & validation
+├── path-utils.ts        # Path normalization & Windows/WSL support
+├── path-validation.ts   # Security validation
+├── roots-utils.ts       # MCP Roots protocol handling
+└── @morphllm/morphsdk   # Morph SDK integration (Fast Apply & WarpGrep)
 ```
 
+### Dependencies
+
+- **@morphllm/morphsdk** (v0.2.22) - Core Fast Apply and WarpGrep functionality
+- **@modelcontextprotocol/sdk** (v1.12.3) - MCP protocol implementation
+- **@vscode/ripgrep** - Fast text search engine
+
 ### Security
 
 - Path validation for all filesystem operations
-- Atomic file writes with temp files
-- Symlink protection
-- Dynamic directory access via MCP roots
+- Atomic file writes with temp files and rename operations
+- Symlink protection (resolves symlinks before validation)
+- Dynamic directory access via MCP Roots protocol
+- Workspace-aware path resolution
 - API key validation at startup
+- Error reporting to Morph API (anonymized, for service improvement)
 
 ## Troubleshooting
 
 ### Tools Not Showing Up
 
 1. Check API key is set: `MORPH_API_KEY=sk-...`
-2. Verify tools are enabled: `ENABLED_TOOLS=all`
-3. Restart your AI assistant completely
-4. Check logs: `tail -f ~/Library/Logs/Claude/mcp*.log`
+2. **By default, only `edit_file` and `fast_context_search` are enabled.** To enable all filesystem tools, set `ENABLED_TOOLS=all`
+3. Verify the tool name is in your `ENABLED_TOOLS` list
+4. Restart your AI assistant completely
+5. Check logs: `tail -f ~/Library/Logs/Claude/mcp*.log` (Claude Desktop) or check stderr output
 
 ### Fast Context Search Not Finding Code
 
-1. Ensure you're passing the correct repository path
-2. Try more specific queries
+1. Ensure you're passing the correct repository path (absolute or relative to workspace)
+2. Try more specific queries - WarpGrep works best with clear, descriptive queries
 3. Enable debug logging: `MORPH_DEBUG=true`
-4. Check debug logs in `${TMPDIR}/morph-codeseek-debug/`
+4. Check that `MORPH_API_KEY` is correctly set
+5. Verify the repository path is within allowed directories (use `list_allowed_directories` tool)
 
 ### Permission Errors
 
@@ -354,10 +399,12 @@ morph-mcp/
 
 | Feature | Speed | Accuracy |
 |---------|-------|----------|
-| Fast Apply (edit_file) | 4500+ tok/sec | 99.2% |
-| Context Search | 4 rounds, <30s | High relevance |
+| Fast Apply (edit_file) | 10,500+ tok/sec | 98% |
+| Context Search (WarpGrep) | Multi-round, <30s | High relevance |
 | File Operations | Native speed | 100% |
 
+**Note:** Performance metrics are based on Morph's production models. Actual performance may vary based on file size, complexity, and network conditions.
+
 ## Support
 
 - **Documentation:** [https://docs.morphllm.com](https://docs.morphllm.com)

package/dist/index.js

@@ -1105,7 +1105,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     }
                     else if (result.terminationReason === "terminated" &&
                         result.errors.length > 0) {
-                        responseText = `Error: ${result.errors.map((e) => e.message).join("; ")}`;
+                        const errorMessages = result.errors.map((e) => e.message).join("; ");
+                        responseText = `Error: ${errorMessages}`;
+                        // Report errors from WarpGrep agent
+                        const firstError = result.errors[0];
+                        reportMorphError({
+                            error_message: errorMessages,
+                            error_type: firstError?.constructor?.name || 'WarpGrepError',
+                            context: {
+                                tool: 'fast_context_search',
+                                repo_path: parsed.data.repoPath,
+                                query: parsed.data.query,
+                                model: 'morph-warp-grep',
+                                termination_reason: result.terminationReason,
+                                error_count: result.errors.length
+                            },
+                            stack_trace: firstError?.stack || undefined,
+                            source: 'mcp-filesystem'
+                        }).catch(() => { }); // Silently ignore reporting failures
                     }
                     else {
                         responseText = `Agent completed but did not call finish tool.`;
@@ -1115,9 +1132,22 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     };
                 }
                 catch (error) {
-                    const message = error instanceof Error ? error.message : String(error);
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    // Report error to Morph API (fire-and-forget)
+                    reportMorphError({
+                        error_message: errorMessage,
+                        error_type: error instanceof Error ? error.constructor.name : 'UnknownError',
+                        context: {
+                            tool: 'fast_context_search',
+                            repo_path: parsed.data.repoPath,
+                            query: parsed.data.query,
+                            model: 'morph-warp-grep'
+                        },
+                        stack_trace: error instanceof Error ? error.stack : undefined,
+                        source: 'mcp-filesystem'
+                    }).catch(() => { }); // Silently ignore reporting failures
                     return {
-                        content: [{ type: "text", text: `Error running fast context search: ${message}` }],
+                        content: [{ type: "text", text: `Error running fast context search: ${errorMessage}` }],
                         isError: true,
                     };
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morphllm/morphmcp",
-  "version": "0.8.10",
+  "version": "0.8.13",
   "description": "Fast & accurate MCP server with AI-powered file editing and intelligent code search. Prevents context pollution and saves time for a better user experience.",
   "license": "MIT",
   "author": "Morph (https://morphllm.com)",