Advertise
MCP.so
Sign In

MCP Server Basic Example

@ugundhar

Repository

Basic information

Category

Other

License

NOASSERTION

Transports

stdio

Author

ugundhar

About MCP Server Basic Example

complete mcp server

#mcp-server#model-context-protocol#server-implementation

MCP Server Basic Example config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-ugundhar": {
      "command": "uv",
      "args": [
        "init",
        "mcp-server-basic"
      ]
    }
  }
}

MCP Server Basic Example tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server Basic Example?

MCP Server Basic Example is a minimal reference implementation of the Model Context Protocol (MCP) server in Python. It demonstrates core MCP capabilities—tools and resources—and is intended for developers learning how to build MCP servers.

How to use MCP Server Basic Example?

Initialize a project with uv init mcp-server-basic, create a virtual environment, and install mcp[cli]. Run the server for inspection with uv run mcp dev main.py, or normally with uv run mcp run. To install in Claude Desktop, use uv run mcp install main.py. For VS Code, run uv run main.py then open the chat with Ctrl+Shift+I.

Key features of MCP Server Basic Example

  • add(a, b) tool: adds two integers
  • subtract(a, b) tool: subtracts second integer from first
  • greeting://{name} resource: returns a personalized greeting
  • Fully compatible with MCP Inspector and Claude Desktop
  • Minimal Python implementation using uv as package manager

Use cases of MCP Server Basic Example

  • Learning how to implement MCP tools and resources from scratch
  • Testing MCP client‑server communication with the Inspector
  • Bootstrapping a custom MCP server for simple arithmetic or greeting functions
  • Integrating with Claude Desktop for demonstration purposes

Frequently asked questions

1

What tools does the server provide?

The server exposes two integer arithmetic tools: `add(a, b)` and `subtract(a, b)`.

2

What resources does the server provide?

It provides a single dynamic resource `greeting://{name}` that returns a personalized greeting string.

3

How do I run the server in development mode?

Use `uv run mcp dev main.py` to launch the server with the MCP Inspector for testing and debugging.

4

How do I install the server in Claude Desktop?

Run `uv run mcp install main.py` from the project directory to register the server with Claude Desktop.

5

How do I connect the server in VS Code?

Open the project folder in VS Code, run `uv run main.py` in the terminal, then press Ctrl+Shift+I to launch the VS Code chat interface and configure the MCP connection.

Comments

More Other MCP servers

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Advertise