MCP Keyword Search Server

This project implements a Model Context Protocol (MCP) server and client using Node.js.
It allows you to search for a specific keyword within a given text file — demonstrating how MCP tools can communicate via standard input/output.

---

Table of Contents

• Features
• Project Structure
• Setup Instructions
  • 1. Clone the repository
  • 2. Install dependencies
  • 3. Run the client
• How It Works
• Example File
• Screenshots
• License
• Contact

---

Features

• Built with @modelcontextprotocol/sdk
• Implements a custom MCP tool: keyword-search
• Searches text files for specific keywords
• Clean, color-coded output using chalk
• Fully open-source and lightweight

---

Project Structure

mcp-server/<br/> │<br/> ├── index.js # MCP Server implementation<br/> ├── client.js # Client sending keyword-search requests<br/> ├── sample.txt # Sample input file<br/> ├── package.json<br/> ├── .gitignore<br/> ├── LICENSE<br/> └── README.md<br/>

---

Setup Instructions

1. Clone the repository

git clone https://github.com/TuShArBhArDwA/mcp-keyword-search-server.git
cd mcp-keyword-search-server

2. Install dependencies

npm install

3. Run the client

node client.js

You should see output similar to:

Starting MCP Keyword Search Server...

Sending keyword-search request...

Search Result:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Found 1 line(s):
This is Tushar
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

---

How It Works

• The MCP server (index.js) defines a tool keyword-search using the SDK.
• The client (client.js) sends an MCP request with file path and keyword.
• The server reads the file, finds matching lines, and returns the result.

---

Example File

sample.txt

Hello world
This is Tushar
Keyword search test

Example Request:

{
  "filePath": "sample.txt",
  "keyword": "Tushar"
}

Response

Found 1 line(s):
This is Tushar

---

Screenshots

<img width="940" height="214" alt="image" src="https://github.com/user-attachments/assets/c4fd6196-2c9e-4b36-812a-f3c82074bb9f" />

Salesforce Custom Object Screenshot

<img width="594" height="365" alt="image" src="https://github.com/user-attachments/assets/e368f7e6-65b8-43d1-bf61-3982107b39bd" />

MCP Server Output Screenshot

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Contact

• Meet T-Bot - Discover My Work
• Tushar Bhardwaj - Portfolio
• Connect 1:1 - Topmate
• GitHub: TuShArBhArDwA
• LinkedIn: Tushar Bhardwaj
• Email: tusharbhardwaj2617@example.com