MCP_Python
If you are the rightful owner of MCP_Python and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This is a demonstration implementation of a Model Context Protocol (MCP) server.
MCP Server Demo
Overview
This is a demonstration implementation of a Model Context Protocol (MCP) server. The MCP protocol facilitates communication between clients and AI models, providing a standardized way to exchange prompts, context, and model responses.
Purpose
The purpose of this project is to demonstrate the implementation of a Model Context Protocol (MCP) server using the FastMCP framework. The server provides tools for file operations, such as creating, reading, deleting, and searching files, and includes a dynamic resource for personalized greetings. It serves as an example of how to use MCP for efficient communication between clients and AI models.
Installation
Prerequisites
- Python 3.8 or higher
- pip or uv package manager
Setup
- Clone this repository
- Set up a virtual environment:
python -m venv .venv - Activate the virtual environment:
- Windows:
.venv\Scripts\activate - Unix/macOS:
source .venv/bin/activate
- Windows:
- Install dependencies:
pip install -e .
Usage
Run the server with:
python main.py
The server will start listening for client connections on the default port.
Project Structure
main.py: Entry point for the MCP server applicationpyproject.toml: Project configuration and dependenciesuv.lock: Dependency lock file
API
The server implements the Model Context Protocol specification, which includes:
- Request/response format for model interactions
- Context management
- Authentication mechanisms
- Rate limiting
Functions
The following functions are implemented in the MCP server:
-
Dynamic Greeting Resource:
@mcp.resource("greeting://{name}")- Provides a personalized greeting for the given name.
-
File Operations Tools:
list_files(directory_path: str) -> List[str]: Lists all files in a given directory.create_file(file_path: str, content: str = "") -> str: Creates a new file with optional initial content.add_to_file(file_path: str, content: str) -> str: Appends content to an existing file.read_file(file_path: str) -> str: Reads and returns the contents of a file.delete_file(file_path: str) -> str: Deletes a file from the filesystem.search_in_file(file_path: str, search_term: str) -> str: Searches for a term in a file and returns matching lines.rename_file(old_path: str, new_path: str) -> str: Renames or moves a file.
Last updated: April 24, 2025
