# MCP Server using FAST MCP 

This is a sample MCP Server built using **FastAPI** and integrated with **Gemini CLI**.

Repository: `git@github.com:MAIMOONA-ISLAM/MCP-Server-using-FAST-MCP.git`

## Features

- **FastAPI Web Server** with REST endpoints
- **MCP Protocol Server** for Gemini CLI integration
- **Mathematical Operations** (sum calculation)
- **Greeting Service** (personalized greetings)

## Project Structure

`
mcp_fastapi_server/
 .gemini/
    settings.json      # Gemini settings
 demo/
    README.md          # Demo documentation
    screen_recording(1).mp4  # Demo video
 __pycache__/           # Python cache files
 .gitattributes         # Git attributes
 .gitignore            # Git ignore rules
 main.py               # FastAPI web server
 mcp_config.json       # Gemini CLI configuration
 README.md             # This file
 requirements.txt      # Python dependencies
 simple_mcp_server.py  # Simple MCP protocol server
`

## Setup Instructions

### 1. Install Dependencies

`ash
pip install -r requirements.txt
`

### 2. Run FastAPI Server

`ash
uvicorn main:app --reload --port 8000
`

The server will be available at: http://localhost:8000

API Documentation: http://localhost:8000/docs

### 3. Test MCP Server

`ash
python simple_mcp_server.py
`

### 4. Configure Gemini CLI

Copy the mcp_config.json to your Gemini CLI configuration directory:

`ash
# On Windows
copy mcp_config.json %APPDATA%\gemini\mcp_config.json

# On macOS/Linux
cp mcp_config.json ~/.config/gemini/mcp_config.json
`

## Available Endpoints

### FastAPI Endpoints

- GET / - Server status
- POST /sum - Calculate sum of two numbers
- POST /greet - Generate greeting message

### MCP Tools

- calculate_sum - Calculate sum of two numbers
- greet_user - Generate personalized greeting

## Usage Examples

### FastAPI Usage

`ash
# Test sum endpoint
curl -X POST "http://localhost:8000/sum" \
     -H "Content-Type: application/json" \
     -d '{"a": 5, "b": 3}'

# Test greet endpoint
curl -X POST "http://localhost:8000/greet" \
     -H "Content-Type: application/json" \
     -d '{"name": "World"}'
`

### Gemini CLI Usage

`ash
# List available MCP tools
gemini mcp list

# Use MCP tools
gemini mcp call calculate_sum --a 5 --b 3
gemini mcp call greet_user --name "Alice"
`

## Demo

Check out the demo/ folder for:
- Screen recording demonstrating the MCP server in action
- Additional demo documentation
- Examples of server setup and Gemini CLI MCP commands

## Requirements

See `requirements.txt` for the full list of Python dependencies.

## License

This project is open source and available for educational purposes.

## Contributing

Feel free to submit issues and enhancement requests!