MCP Deployment
A Model Context Protocol (MCP) server that exposes a sum_numbers tool for summing lists of integers. This project demonstrates a simple MCP server implementation using FastMCP.
Project Overview
This MCP deployment project provides:
- sum_numbers Tool: A simple tool that takes a list of integers and returns their sum
- FastMCP Server: Built on the MCP FastMCP framework for easy server implementation
- Python 3.13+: Uses modern Python with type hints and async support
Installation
Prerequisites
- Python 3.13 or higher
uvpackage manager (recommended) orpip
Using uv (Recommended)
-
Install
uv(if not already installed):# On Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex" # On macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh -
Clone the repository:
git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git cd mcp-deployment -
Create a virtual environment and install dependencies:
uv sync -
Run the MCP server:
uv run mcp-server
Using pip
-
Clone the repository:
git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git cd mcp-deployment -
Create a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate -
Install dependencies:
pip install -e . -
Run the MCP server:
mcp-server
Configuration
Claude Desktop Configuration
To use this MCP server with Claude Desktop, add the following configuration to your claude_desktop_config.json:
{
"mcpServers": {
"Sum-numbers": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment@main",
"mcp-server"
]
}
}
}
Location of claude_desktop_config.json:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Alternative Local Configuration
If you prefer to run the server locally, use:
{
"mcpServers": {
"sum-numbers": {
"command": "python",
"args": [
"-m",
"mcpserver"
],
"cwd": "/path/to/mcp-deployment"
}
}
}
Available Tools
sum_numbers
Sums a list of integers.
Parameters:
numbers(list[int]): A list of integers to be summed
Returns:
- (int): The sum of all integers in the list
Example:
result = sum_numbers([1, 2, 3, 4, 5])
# Returns: 15
Project Structure
mcp-deployment/
src/
mcpserver/
__init__.py
__main__.py
deployment.py
pyproject.toml
README.md
uv.lock
Dependencies
mcp[cli]>=1.23.1: Model Context Protocol library with CLI support- Python 3.13+
Development
To contribute or modify the server:
-
Install in development mode:
uv sync -
Edit
src/mcpserver/deployment.pyto add new tools or modify existing ones -
Test locally:
uv run mcp-server
License
This project is open source. See LICENSE file for details.
Support
For issues or questions, please open an issue on GitHub: mcp-deployment Issues