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

Related MCP server: MCP Keyword Search Server

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

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

Salesforce Custom Object Screenshot

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