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.

Related MCP Servers

  • -
    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 -
    56
    Python
    GPL 3.0
  • -
    security
    F
    license
    -
    quality
    A sample implementation of Model Context Protocol server demonstrating core functionality with simple arithmetic tools and greeting resources.
    Last updated -
    Python
  • -
    security
    F
    license
    -
    quality
    A basic Model Context Protocol server implementation that demonstrates core functionality including tools and resources for AI chat applications.
    Last updated -
    Python
  • A
    security
    F
    license
    A
    quality
    A Model Context Protocol server implementation that provides basic utility tools including echo, uppercase text conversion, and mathematical calculations.
    Last updated -
    3
    738
    JavaScript

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