# 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)