# Simple MCP Server (FastMCP)
This repository demonstrates how to create, test, and deploy a **simple remote MCP server** using **FastMCP**, **uv**, and **GitHub**.
---
## Prerequisites
Make sure you have the following installed:
- Python 3.10+
- `uv` (Python package manager)
- Git
- VS Code (recommended)
- Node.js (for MCP Inspector)
---
## Step-by-Step Guide
### 1. Install `uv`
`uv` is a fast Python package manager and runtime.
```bash
pip install uv
```
---
### 2. Create a new project folder
```bash
mkdir simple-mcp-server
cd simple-mcp-server
```
---
### 3. Open the folder in VS Code
```bash
code .
```
---
### 4. Initialize the project
```bash
uv init
```
This creates:
- `pyproject.toml`
- Virtual environment configuration
---
### 5. Install FastMCP
```bash
uv add fastmcp
```
FastMCP allows you to build MCP-compatible servers easily.
---
### 6. Create a simple server
Create a file called `main.py`:
```python
from fastmcp import FastMCP
mcp = FastMCP("Simple MCP Server")
@mcp.tool()
def hello(name: str) -> str:
return f"Hello, {name}! Welcome to MCP."
if __name__ == "__main__":
mcp.run()
```
---
### 7. Run the server
```bash
uv run main.py
```
Your MCP server will start locally.
---
### 8. Test using MCP Inspector
Use **MCP Inspector** to:
- Connect to the server
- Verify tools are listed
- Send test requests
This confirms your server is MCP-compliant.
---
### 9. Create a GitHub repository
Create a new repo on GitHub named:
```
simple-mcp-server
```
---
### 10. Initialize Git locally
```bash
git init
git add .
git commit -m "Initial commit: Simple MCP server"
```
---
### 11. Add GitHub remote & push
```bash
git remote add origin https://github.com/yourusername/simple-mcp-server.git
git push -u origin main
```
---
### 12. Deploy on FastMCP Cloud
1. Create an account on **FastMCP Cloud**
2. Connect your GitHub repository
3. Deploy the project
After deployment:
- Your MCP server gets a public endpoint
- It can be used by MCP clients and LLM agents
---
## Project Structure
```
simple-mcp-server/
│── main.py
│── pyproject.toml
│── README.md
```
---
## Next Steps
- Add more MCP tools
- Connect this server to LLM agents
- Add authentication & logging
---
Happy building 🚀
