# My First MCP Server

## Project Purpose

This project is my first implementation of a Model Context Protocol (MCP) server as part of the Nextflows Academy MCP training.

The server exposes a simple tool called **greet**, which accepts a user's name as input and returns a greeting message. The project demonstrates the basic structure of an MCP server using the official TypeScript SDK and shows how tools are registered and tested using MCP Inspector.

---

## Technologies Used

- Node.js
- TypeScript
- Model Context Protocol (MCP) SDK v1.29.0
- Zod
- MCP Inspector

---

## Project Structure

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

---

## How to Run the Project

### 1. Clone the repository

```bash
git clone https://github.com/yarakhattab/my-first-mcp.git
```

### 2. Open the project folder

```bash
cd my-first-mcp
```

### 3. Install the dependencies

```bash
npm install
```

### 4. Start the MCP server

```bash
npm run dev
```

The server will start and wait for incoming MCP requests.

---

## Testing with MCP Inspector

Run the following command:

```bash
npx @modelcontextprotocol/inspector npx tsx src/index.ts
```

Open the URL displayed in your terminal.

Then:

- Open the **Tools** tab.
- Select the **greet** tool.
- Enter a name.
- Click **Run**.
- The server should return a greeting message.

---

## Academy Website

Nextflows Academy

https://academy.nextflows.com/

---

## Author

Yara Khattab