MCP Tools logo

MCP Tools

by ZbigniewTomanek

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 in a controlled way through well-defined tool interfaces.

View on GitHub

Last updated: N/A

What is MCP Tools?

This is a FastMCP server implementation that provides a standardized way for LLMs like Claude to interact with your local file system and execute commands. It allows LLMs to access data sources and tools in a controlled and secure manner.

How to use MCP Tools?

  1. Install Python 3.10 or higher and uv. 2. Clone the repository. 3. Run uv run mcp install. 4. Configure your MCP server in Claude Desktop with the absolute path to the uv executable and the server.py file. 5. Connect to the MCP server from Claude Desktop using the identifier 'zbigniew-mcp'. Use the available tools like execute_shell_command, show_file, search_in_file, edit_file, and write_file to interact with the file system and execute commands.

Key features of MCP Tools

  • Standardized Integration with MCP

  • File system access for LLMs

  • Command execution capabilities

  • Extensible with custom tools using the @mcp.tool decorator

  • Supports multiple transport mechanisms (stdio, SSE)

Use cases of MCP Tools

  • Allowing LLMs to analyze local files

  • Enabling LLMs to execute scripts and programs

  • Providing LLMs with access to system information

  • Automating file editing and modification tasks

  • Fetching web page content and converting it to markdown

FAQ from MCP Tools

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs).

What LLMs are compatible with this server?

This implementation focuses on Claude Desktop, but MCP is designed to be compatible with any MCP-compatible tool or LLM client.

How do I add new tools to the server?

You can extend the MCP server by adding new tools with the @mcp.tool decorator. Follow the pattern in server.py to create new tools.

What transport mechanisms are supported?

MCP supports multiple transport methods for communication between clients and servers: Standard Input/Output (stdio) and Server-Sent Events (SSE).

What are the security considerations?

The MCP server provides Claude with access to your local system. Be mindful that the server executes shell commands as your user and can read, write, and modify files on your system. Consider limiting access to specific directories if security is a concern.