home / mcp / mcp files server

MCP Files Server

A comprehensive MCP server providing helpful tools for AI agents like Cursor

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "orionpotter-flesler-mcp-tools": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "PORT": "3000",
        "DEBUG": "true",
        "TRANSPORT": "stdio"
      }
    }
  }
}

You can use MCP tools to locate and surgically edit code across a large codebase with precision. It lets you discover symbols anywhere, inspect their definitions, and apply targeted changes without disturbing surrounding code, which is ideal for refactoring, code reviews, and maintaining consistency across a project.

How to use

Set up your MCP client to connect to the MCP server you will run locally or remotely. Use the NPX option for quick, zero-install access, or run a dedicated HTTP transport if you need a streaming HTTP connection.

How to install

Prerequisites: Node.js (version 20 or higher) and npm or npx. You may also run the server via Docker if you prefer containerized execution.

HTTP transport and local setup

To enable HTTP transport, first start the server in HTTP mode, then configure your MCP client to point to the HTTP endpoint.

Configuration examples

{
  "mcpServers": {
    "mcp-files": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Practical usage patterns

Use the HTTP transport to query the server for symbol locations and then apply surgical edits using the local NPX-based server for fast iterations.

Troubleshooting

Common issues include transport misconfigurations or missing dependencies. Ensure you are running Node.js v20 or higher and verify that the MCP server is reachable at the configured URL. If you encounter module resolution errors when starting via NPX, clear the NPX cache and retry the command.

Available tools

read_symbol

Find and extract code blocks by symbol name(s) across the repository. Supports multiple symbols and optimization to prepare AI-ready content.

import_symbol

Inspect JavaScript/TypeScript modules and their properties to understand module exports and structures.

search_replace

Search and replace text with whitespace handling and support for multiple matches across files.

insert_text

Insert or replace text at precise line ranges, enabling surgical edits in large files.

os_notification

Send operating system notifications to alert you when tasks complete.