MCP Deployment

# 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): ```bash # 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**: ```bash git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git cd mcp-deployment ``` 3. **Create a virtual environment and install dependencies**: ```bash uv sync ``` 4. **Run the MCP server**: ```bash uv run mcp-server ``` ### Using `pip` 1. **Clone the repository**: ```bash git clone https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment.git cd mcp-deployment ``` 2. **Create a virtual environment**: ```bash python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate ``` 3. **Install dependencies**: ```bash pip install -e . ``` 4. **Run the MCP server**: ```bash mcp-server ``` ## Configuration ### Claude Desktop Configuration To use this MCP server with Claude Desktop, add the following configuration to your `claude_desktop_config.json`: ```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: ```json { "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**: ```python 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: ```bash uv sync ``` 2. Edit `src/mcpserver/deployment.py` to add new tools or modify existing ones 3. Test locally: ```bash 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](https://github.com/Mandapati-SuryanarayanaRaju/mcp-deployment/issues)