Simple Remote Server

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.

pip install uv

---

2. Create a new project folder

mkdir simple-mcp-server
cd simple-mcp-server

---

3. Open the folder in VS Code

code .

---

4. Initialize the project

uv init

This creates:

• pyproject.toml
• Virtual environment configuration

---

5. Install FastMCP

uv add fastmcp

FastMCP allows you to build MCP-compatible servers easily.

---

6. Create a simple server

Create a file called main.py:

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

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

git init
git add .
git commit -m "Initial commit: Simple MCP server"

---

11. Add GitHub remote & push

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 🚀