# 🧮 My MCP Server

![Node.js](https://img.shields.io/badge/Node.js-18%2B-green?style=for-the-badge&logo=nodedotjs)
![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=for-the-badge&logo=typescript)
![MCP SDK](https://img.shields.io/badge/MCP_SDK-Latest-orange?style=for-the-badge&logo=anthropic)
![License](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge)

> A simple **Model Context Protocol (MCP)** server built with Node.js, TypeScript, and the MCP TypeScript SDK.

---

> [!NOTE]  
> Designed for seamless integration with LLMs to provide real-time tool execution via standard I/O.

---

## ✨ Features

- 🚀 **Stdio Transport:** Reliable local inter-process communication via `stdio`.
- ⚡ **`add_numbers` Tool:** Exposes addition calculations directly to context-aware models.
- 🛡️ **Type-Safe Validation:** Full input schema validation powered by **Zod**.
- 🧪 **Inspector Tested:** Fully tested and verified using the official **MCP Inspector**.

---

## 🛠️ Tech Stack

| Technology | Role |
| :--- | :--- |
| **Node.js** | Server Runtime Environment |
| **TypeScript** | Type-Safe Application Logic |
| **MCP SDK** | Model Context Protocol Implementation |
| **Zod** | Schema & Argument Validation |

---

## 📂 Project Structure

```text
my-mcp-server/
├── 📁 src/
│   └── 📄 index.ts
├── 📄 .gitignore
├── 📄 package.json
├── 📄 package-lock.json
├── 📄 tsconfig.json
└── 📄 README.md