MCP Server Deployment Demo
This project is a demonstration of how to create and deploy a simple server that adheres to the Model-Context-Protocol (MCP). It provides a basic tool that can be called by an MCP client, such as an AI model like Claude.
Overview
The Model-Context-Protocol (MCP) is a specification for communication between a large language model (or other AI agent) and a local development environment. It allows the model to access local context and execute tools securely.
This project implements a simple MCP server using the mcp Python library. The server exposes a single tool, add, which takes two integers and returns their sum.
Features
- A simple
FastMCPserver implementation. - A basic
add(x: int, y: int) -> inttool. - Packaged as a Python project using
pyproject.tomlandsetuptools. - Ready for installation and deployment.
Project Structure
pyproject.toml: Defines project metadata, dependencies, and build configuration. The[project.scripts]section defines themcp-servercommand.src/mcpserver/deployment.py: Contains the core logic for the MCP server, including the definition of theaddtool.src/mcpserver/__main__.py: Provides the main entry point to run the server from the command line.
Getting Started
Prerequisites
- Python 3.12+
- uv (a fast Python package installer and resolver)
Installation
-
Clone the repository:
git clone https://github.com/AdarshChaudhary03/mcp-server-deployment.git cd mcp-server-deployment -
Install dependencies: Create a virtual environment and install the project in editable mode.
uv venv source .venv/bin/activate uv pip install -e .
Running the Server
Once installed, you can run the MCP server using the script defined in pyproject.toml:
mcp-server
Claude Integration
To use this server as an MCP host for a client like Claude, you need to update your Claude configuration file (claude-config.json). Add the following entry to the mcpHosts section.
This configuration tells the Claude client how to launch and communicate with your MCP server. It uses uvx to run the server directly from the Git repository, ensuring you are always using the latest version.
Note: Make sure to replace the command and directory paths with the correct absolute paths for your system.
"MCPServer": {
"command": "/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx",
"args": [
"--directory",
"/Users/adarshchaudhary/Desktop/ai-projects/mcp-servers/mcp-server-deployment",
"--from",
"git+https://github.com/AdarshChaudhary03/mcp-server-deployment",
"mcp-server"
]
}