Skip to main content
Glama

MCP Server Basic Example

by rezaeim

MCP Server Basic Example

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
  1. Create virtual environment and activate it

uv venv .venv\Scripts\activate
  1. Install dependencies:

uv add "mcp[cli]"

or

uv add -r requirements.txt

Related MCP server: MCP Server Basic Example

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

  • Folow the below steps (two way to add mcp configuration for vs code user settings):

Watch the demo

Project Structure

  • main.py: Main server implementation with tools and resources

  • pyproject.toml: Project configuration and dependencies

-
security - not tested
A
license - permissive license
-
quality - not tested

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rezaeim/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server