My

You run a local MCP server that exposes dedicated tools for LLM clients to interact with your file system and execute commands. It enables Claude Desktop and other MCP-compatible clients to securely access and manipulate local data through standardized tool interfaces.

How to use

Connect your MCP client to the local server using the provided stdio configuration. Once connected, you can request tools to execute shell commands, inspect files, search within code, edit content precisely, and write or append data. Use the tools through your client’s MCP integration to perform common automation and scripting tasks on your machine.

How to install

Prerequisites you need before installation are Python 3.10 or higher and an MCP-compatible client.

Install the MCP runtime tool known as uv. This is required to run the MCP server locally.

Prepare your environment and start the MCP server using the provided commands.

uv run mcp install

which uv

# Update your MCP server configuration in your MCP client to use the absolute path to the uv executable

The example below demonstrates how the server is configured for a local setup. You would place this in your client’s MCP configuration file to establish the 1:1 connection with the local server.

## Configuration and security

This MCP server exposes file system and command execution capabilities to your MCP clients. It runs commands with your user permissions, can read, write, and modify local files, and can view or edit contents as specified by the tools.

Limit access to trusted hosts and clients to minimize security risks. Only connect your MCP-enabled clients that you trust to execute sensitive operations.

## Examples and notes

Available tools include executing shell commands, showing file contents, performing regex searches in files, editing files with precise line operations, and writing or appending to files. You can chain these tools to automate local maintenance tasks.

If you have a local server configuration, you should confirm the path to the uv executable is correct in your client settings and that the server script path is accessible.

## Troubleshooting

If the client cannot connect, verify that the uv executable path is correct and that the server script path exists. Check file permissions and ensure the MCP server has access to the targeted directories.

## Available tools

### execute\_shell\_command

Execute shell commands safely by providing a list of arguments and capturing stdout and stderr.

### show\_file

Display the contents of a file with optional line range or limits.

### search\_in\_file

Search for patterns in files using regular expressions with optional case sensitivity.

### edit\_file

Edit files with precise changes, including replacements and line-based operations like insert, delete, and replace.

### write\_file

Write or append content to files, with options to overwrite or append.

### fetch\_page

Fetch the contents of a web page and process it locally (e.g., convert to markdown) using local AI models.