simple-mcpserver

abhilash-radhakrishnaru/simple-mcpserver

3.2

If you are the rightful owner of simple-mcpserver and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a structured overview of a simple Model Context Protocol (MCP) server, its features, tools, resources, and usage across different platforms.

Simple MCP Server Example

This project demostrates building a simple mcp server and testing it

How to Run

create a virtual environment, activate it & install dependencies

    uv venv
    source .venv/bin/activate
    uv add -r requirements.txt

Run python main.py(after enabling main) and it will start listening in a URL(http://127.0.0.1:8000/mcp/). If the protocol is stdio, it simply waits for the input

MCP Inspector

MCP Server is a dev tool for debugging & testing. Quick way to test the MCP server before its used in the LLM.

To start the application with MCP Inspector, run "mcp dev main.py".

This will launch the MCP Inspector at http://127.0.0.1:6274

access the inspector from http://127.0.0.1:6274 and play around with Tools, Prompts & Resources.
Check the differences in how the return values are sent back
In this case MCP client is the MCP Inspector

From Claude Desktop We can also install this mcp and access it via Claude desktop mcp install main.py You need to restart Claude after this to see the application getting reflected in settings -> Developer Testing in Claude: # in Cluade, after integration, type "Add two numbers 3 and 4" to see this function kicks in # prompts can be used from "+" symbol In this case MCP client is the Claude Desktop application

We can also run mcp using mcp run main.py. In this case, the transport porotocol will be stdio. can run it using http so that it can be accessed remotly. eg: mcp run --transport sse main.py