Skip to content
Back to search

mini-mcp-server

A Python implementation of a Model Context Protocol server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kushwaha-ashutosh--mini-mcp-server/badge.svg)](/listings/kushwaha-ashutosh--mini-mcp-server)

HTML

<a href="/listings/kushwaha-ashutosh--mini-mcp-server"><img src="/api/listings/kushwaha-ashutosh--mini-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Clone the repository:

git clone https://github.com/kushwaha-ashutosh/mini-mcp-server.git
cd mini-mcp-server

Create and activate a virtual environment:

python -m venv venv

Windows PowerShell:

.\venv\Scripts\Activate.ps1

Install dependencies:

pip install -r requirements.txt

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 97 lines
  1. # Mini MCP Server
  2. A beginner-friendly implementation of a Model Context Protocol (MCP) server using Python and the MCP Python SDK.
  3. ## Overview
  4. This project demonstrates how to build an MCP server that exposes tools, resources, and prompts to MCP-compatible AI applications.
  5. ## Features
  6. - **Tools:** Perform operations such as addition and multiplication.
  7. - **Resources:** Expose learning notes through a resource URI.
  8. - **Prompts:** Provide reusable prompt templates for explaining MCP concepts.
  9. - **Transport:** Uses STDIO for local communication.
  10. ## Project Structure
  11. ```text
  12. mini-mcp-server/
  13. ├── server.py
  14. ├── requirements.txt
  15. ├── .gitignore
  16. └── README.md
  17. ```
  18. ## Installation
  19. Clone the repository:
  20. ```bash
  21. git clone https://github.com/kushwaha-ashutosh/mini-mcp-server.git
  22. cd mini-mcp-server
  23. ```
  24. Create and activate a virtual environment:
  25. ```bash
  26. python -m venv venv
  27. ```
  28. Windows PowerShell:
  29. ```powershell
  30. .\venv\Scripts\Activate.ps1
  31. ```
  32. Install dependencies:
  33. ```bash
  34. pip install -r requirements.txt
  35. ```
  36. ## Running the Server
  37. ```bash
  38. python server.py
  39. ```
  40. The server uses STDIO transport and is intended to be launched by an MCP client.
  41. ## Available Capabilities
  42. ### Tools
  43. | Tool | Description |
  44. |---|---|
  45. | `add(a, b)` | Adds two numbers |
  46. | `multiply(a, b)` | Multiplies two numbers |
  47. ### Resources
  48. | URI | Description |
  49. |---|---|
  50. | `notes://welcome` | Returns introductory MCP notes |
  51. ### Prompts
  52. | Prompt | Argument | Description |
  53. |---|---|---|
  54. | `explain_mcp` | `topic` | Generates a structured explanation of an MCP topic |
  55. ## Technologies
  56. - Python
  57. - Model Context Protocol (MCP)
  58. - MCP Python SDK
  59. ## Learning Objectives
  60. - Understand MCP architecture.
  61. - Learn the difference between tools, resources, and prompts.
  62. - Understand STDIO transport.
  63. - Build MCP clients and connect them to servers.
  64. ## License
  65. This project is open-source and available under the MIT License.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.