execute_shell_commandLABSCO SUMMARY
A shell and an editor, exposed deliberately.
This is the small, readable version of local system access: six tools, each doing one thing, instead of a framework. It runs with the permissions of the account that launches it, so scope that account to what you want reachable.
What it is
A FastMCP server that gives Claude Desktop or any other MCP client six tools: shell execution, reading, searching, editing and writing files, and fetching a web page, which it saves as a PDF with Chromium and converts to markdown with a local LLM.
What you get
- Shell commands run, with stdout and stderr returned
- File contents shown, optionally limited to a line range
- Regular-expression search inside a file
- Precise edits by string replacement and line operations, and content written to a file or appended to it
- A web page fetched with
fetch_page, saved as a PDF with Chromium and turned into markdown by a local LLM
Requirements
Python 3.10 or higher and uv; fetch_page also needs Chromium installed. Install with uv run mcp install, then point your client at the absolute path to the uv executable.
Setup effort
Build from source — git clone https://github.com/ZbigniewTomanek/my-mcp-server.git
USE CASES
01
Letting the assistant run the build and read the error
Execute the command, get stdout and stderr back, then open the file the error points at.
02
Finding every place a symbol is used
Search the file with a regular expression instead of eyeballing it.
03
Applying a fix the assistant just described
Make the change as a string replacement rather than pasting a whole file back.
04
Reading only the part of a long file that matters
Show a line range instead of loading the whole thing into context.
05
Writing out a config or script it generated
Write the content to a path, or append to what is already there.
6 tools
Listed in project docs. Your client may show a different list.
show_filesearch_in_fileedit_filewrite_filefetch_pageBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
Python 3.10 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/ZbigniewTomanek/my-mcp-server.git
cd my-mcp-server
uv run mcp install
which uvMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"zbigniew-mcp": {
"command": "<YOUR_ABSOLUTE_PATH_PRINTED_WHICH_UV>",
"args": [
"run",
"--with",
"mcp[cli]",
"--with",
"marker-pdf",
"mcp",
"run",
"<YOUR_MCP_SERVER_CLONE>"
]
}
}
}
