Fsext Mcp Server Typescript
@kurtzhi
A high-performance, secure, and production-grade Model Context Protocol (MCP) server built with TypeScript, providing comprehensive filesystem operations, advanced text search & replace, image processing, and Tesseract OCR capabilities. Designed for LLM agent integration, it deli
A high-performance, secure, and production-grade Model Context Protocol (MCP) server built with TypeScript, providing comprehensive filesystem operations, advanced text search & replace, image processing, and Tesseract OCR capabilities. Designed for LLM agent integration, it delivers strict input validation, standardized response structures, streaming large-file processing, and multi-transport remote deployment support.
Core Features Full Filesystem CRUD & Directory Management:Complete file/directory creation, deletion, copy, move, metadata query, and existence verification. Supports recursive full-directory tree replication and safe move operations with conflict protection.
Streaming File I/O for Large Files:Implements segmented text reading, chunked binary streaming reading, text/binary overwriting and appending. Avoids full memory loading, perfectly supporting GB-level large file processing.
Advanced Text Search & In-Place Replace:Directory-wide recursive content search, single/multi-file contextual matching with preview lines, regular expression support, case-insensitive matching, and precise in-file text replacement with change statistics.
Professional Image Processing Suite:Built-in high-performance image resize (aspect ratio lock support), precise crop, and arbitrary-angle rotation based on Sharp, covering mainstream image editing scenarios.
Cross-Platform Tesseract OCR:WASM-first OCR recognition with customizable local Tesseract binary and tessdata paths, supporting multi-language text extraction from images without local engine installation dependency.
Strict Strict Input Validation & Standardized Response:All tool schemas enable strict additional property prohibition, with unified success/error response structures for consistent client parsing and error handling.
Multi-Standard MCP Transports:Natively supports three official MCP transports: stdio (local client), SSE (legacy remote stream), Streamable HTTP (modern bidirectional remote transport).
Full TypeScript Type Safety:Complete type definitions for all tool parameters, response structures, and transport configurations, ensuring runtime stability and development friendliness.
-
Run without installation npx -y fsext-mcp-server --lock-root /your/workspace # Default STDIO transport with lock root support npx -y fsext-mcp-server --transport stdio npx -y fsext-mcp-server --transport http --host 0.0.0.0 --port 8080 --origin * # Streamable HTTP transport npx -y fsext-mcp-server --transport sse
-
Installation Global Installation (Recommended for CLI Usage) npm install -g fsext-mcp-server Local Project Installation npm install fsext-mcp-server
-
Startup Commands 3.1. Default Stdio Mode (For Claude Desktop / Cursor / Local MCP Clients)
fsext-mcp-server-ts fsext-mcp-server
fsext-ts fsext 3.2. SSE Remote Transport Mode fsext-mcp-server --transport sse --host 0.0.0.0 --port 8000 Endpoints:
SSE Stream Subscription:http://:/sse
Client Request Channel: http://:/messages
3.3. Modern Streamable HTTP Transport Mode fsext-mcp-server --transport http --host 0.0.0.0 --port 8000