# 🎬 Movie Search MCP Server

A simple **Model Context Protocol (MCP)** server built with the official MCP TypeScript SDK.

This project demonstrates how to create a custom MCP server, register tools, validate input using Zod, and test everything using the MCP Inspector.

---

## 🚀 Features

- Search movies by title
- JSON-based movie database
- Input validation using Zod
- MCP Tool registration
- STDIO transport
- Tested using MCP Inspector

---

## 🛠️ Tech Stack

- Node.js
- MCP SDK
- Zod
- JavaScript (ES Modules)
- MCP Inspector

---

## 📁 Project Structure

```text
movie-search-mcp-server/
│
├── tools/
│   └── searchMovie.js
├── movies.json
├── server.js
├── package.json
└── README.md
```

---

## 📦 Installation

Clone the repository

```bash
git clone https://github.com/YOUR_USERNAME/movie-search-mcp-server.git
```

Go to the project

```bash
cd movie-search-mcp-server
```

Install dependencies

```bash
npm install
```

Run the server

```bash
npm start
```

---

## 🧪 Testing

Launch MCP Inspector

```bash
npx @modelcontextprotocol/inspector@latest
```

Connect using

- Transport: STDIO
- Command: node
- Arguments: server.js

---

## 📌 Example Tool

### searchMovie

Input

```json
{
  "title": "Leo"
}
```

Output

```json
{
  "found": true,
  "movie": {
    "title": "Leo",
    "year": 2023,
    "language": "Tamil",
    "hero": "Vijay"
  }
}
```

---

## 📚 Concepts Learned

- Model Context Protocol (MCP)
- MCP Server
- MCP Tools
- STDIO Transport
- Zod Validation
- JSON Data Handling
- MCP Inspector
- Node.js File System

---

## 👨‍💻 Author

Mohanaprasanth K