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.

Related MCP server: custom-mcp-server

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

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

2. Open the project folder

cd my-first-mcp

3. Install the dependencies

npm install

4. Start the MCP server

npm run dev

The server will start and wait for incoming MCP requests.

Testing with MCP Inspector

Run the following command:

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