🎬 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

Related MCP server: xmcp Application

🛠️ Tech Stack

• Node.js

• MCP SDK

• Zod

• JavaScript (ES Modules)

• MCP Inspector

📁 Project Structure

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

📦 Installation

Clone the repository

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

Go to the project

cd movie-search-mcp-server

Install dependencies

npm install

Run the server

npm start

🧪 Testing

Launch MCP Inspector

npx @modelcontextprotocol/inspector@latest

Connect using

• Transport: STDIO

• Command: node

• Arguments: server.js

📌 Example Tool

searchMovie

Input

{
  "title": "Leo"
}

Output

{
  "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