MCP Server

This is a basic example of a Model Context Protocol (MCP) server implementation that demonstrates core functionality including tools and resources.

Setup Steps

1. Initialize the project (Go to any local folder and launch powershell or cmd):

uv init mcp-server-basic
cd mcp-server-basic

2. Create virtual environment and activate it

  uv venv
  .venv\Scripts\activate

3. Install dependencies:

uv add "mcp[cli]"

or

uv add -r requirements.txt

Features

The server implements the following features:

Tools

• add(a: int, b: int): Adds two numbers
• subtract(a: int, b: int): Subtracts second number from first

Resources

• greeting://{name}: Returns a personalized greeting

Running the Server

To run the server with the MCP Inspector for development:

uv run mcp dev main.py

To run the server normally:

uv run mcp run

To install the server in Claude desktop app:

uv run mcp install main.py

MCP connect in VS code

• Open folder/mcp-server-basic in vs code
• open terminal and run below command :

uv run main.py

• Click Cntrl+Shift+I to launch chat in vs code
• Do login with Github and setup

Project Structure

• main.py: Main server implementation with tools and resources
• pyproject.toml: Project configuration and dependencies

push into docker desktop

• make sure your docker desktop is already installed in your system
• run this command in your terminal "docker build -t mcp-server ." to push the mcp server in docker desktop
• "docker run -p [your running port no]:[your running port no] mcp-server"to run the server in docker desktop

Try this out in your desktop and also configure it in your claude,vs code, and cursor