Skip to main content
Glama

MCP Server Basic Example

by rezaeim
GPL 3.0

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

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

A basic implementation of a Model Context Protocol server that demonstrates core functionality with simple math tools (add, subtract) and greeting resources for AI assistants like Claude.

  1. Setup Steps
    1. Create virtual environment and activate it
      1. Features
      2. Running the Server
      3. MCP connect in VS code
      4. Project Structure

    Related MCP Servers

    • A
      security
      F
      license
      A
      quality
      A simple Model Context Protocol server that provides basic arithmetic operations (addition, subtraction, multiplication, division) as tools that can be called by Large Language Models.
      Last updated -
      4
    • -
      security
      A
      license
      -
      quality
      A simple implementation of a Model Context Protocol server that demonstrates core functionality including mathematical tools (add, subtract) and personalized greeting resources.
      Last updated -
      70
      GPL 3.0
    • A
      security
      F
      license
      A
      quality
      A simple Model Context Protocol server that provides standardized tool functionality, currently implementing a basic calculator for adding two numbers together.
      Last updated -
      2
      652
    • -
      security
      F
      license
      -
      quality
      A sample implementation of Model Context Protocol server demonstrating core functionality with simple arithmetic tools and greeting resources.
      Last updated -

    View all related MCP servers

    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