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
• uv package manager (recommended) or pip

Using uv (Recommended)

1. 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
   

2. Clone the repository:

   git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git
   cd mcp-deployment
   

3. Create a virtual environment and install dependencies:

   uv sync
   

4. Run the MCP server:

   uv run mcp-server
   

Using pip

1. Clone the repository:

   git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git
   cd mcp-deployment
   

2. Create a virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install dependencies:

   pip install -e .
   

4. 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:

1. Install in development mode:

   uv sync
   

2. Edit src/mcpserver/deployment.py to add new tools or modify existing ones

3. 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