MCP Tools

What is MCP Tools?

MCP Tools is a custom Model Context Protocol (MCP) server implementation that provides file system and command execution tools for Claude Desktop and other LLM clients. It extends LLMs’ capabilities with local system access through well-defined tool interfaces.

How to use MCP Tools?

Install Python 3.10 or higher and the uv package manager. Clone the repository, run uv run mcp install, then get the absolute path to uv. Update your Claude Desktop MCP server configuration JSON to include the absolute path and the server.py file as arguments. Connect Claude Desktop using the server identifier "zbigniew-mcp".

Key features of MCP Tools

• Execute shell commands with argument lists
• View file contents with optional line ranges
• Search for patterns in files using regular expressions
• Make precise edits: text replacements, line insertions, deletions
• Write or append content to files
• Fetch a web page to PDF and parse it to markdown (requires Chromium)

Use cases of MCP Tools

• Automate code analysis and modification via LLM prompts
• Search and replace across configuration files
• Generate and execute shell scripts for system administration
• Retrieve and process web page content into a usable format

FAQ from MCP Tools

What protocols/transports does MCP Tools support?

It supports standard input/output (stdio) for local processes and Server-Sent Events (SSE) for client-server communication. The implementation uses stdio.

What are the prerequisites for running MCP Tools?

Python 3.10 or higher, the uv package manager, and an MCP-compatible client such as Claude Desktop.

How do I configure MCP Tools in Claude Desktop?

Add an entry to your Claude Desktop MCP server configuration JSON with the absolute path to uv and arguments pointing to the server file. An example configuration is provided in the README.

Can I extend MCP Tools with my own tools?

Yes, add new tools using the @mcp.tool decorator in server.py, following the pattern of the existing tools.

What security considerations should I be aware of?

The server executes shell commands as your user and can read, write, and modify files. Consider limiting access to specific directories if security is a concern.