✅ MCP Server – Keyword Search Tool (Case-Insensitive)

This project is a simple MCP (Model Context Protocol) Server built using FastAPI. It includes a tool that allows users to search for a keyword inside a file (case-insensitive).

📄 Documentation

You can view the detailed documentation here:
Assignment Documentation

📁 Project Structure

mcp-server/ ├── server.py ├── tools/ │ ├── __init__.py │ └── search_tool.py ├── requirements.txt └── README.md

⚙️ 1. Setup Instructions

✅ Step 1: Clone or Create Project Folder

cd mcp-server

✅ Step 2: Create and Activate Virtual Environment (Optional but Recommended)

python -m venv venv # Activate it: # On Windows: venv\Scripts\activate # On Linux/Mac: source venv/bin/activate

✅ Step 3: Install Dependencies

pip install -r requirements.txt

🚀 2. Run the MCP Server

uvicorn server:app --reload --port 8000

If successful, you will see:

Uvicorn running on http://127.0.0.1:8000

Visit in browser:

http://127.0.0.1:8000

Or API docs (auto-generated):

http://127.0.0.1:8000/docs

🔍 3. Search Keyword in a File (API Usage)

✅ Request Format (POST `/search`)

{ "file_path": "path/to/file.txt", "keyword": "example" }

✅ Example using `curl`:

curl -X POST "http://127.0.0.1:8000/search" \ -H "Content-Type: application/json" \ -d '{"file_path": "sample.txt", "keyword": "hello"}'

✅ Example Response:

{ "results": [ "Line 2: Hello World", "Line 5: hElLo again" ] }

🛠 4. Code Summary

`server.py`

Defines API endpoint /search.

✅ 5. Features

✔ FastAPI-powered MCP server ✔ Case-insensitive keyword search ✔ Shows line number + text where keyword exists ✔ Error handling for missing files

📌 6. Future Improvements (Optional)

🔹 Search across directories
🔹 Regex support
🔹 Return JSON with {line_number, content} format
🔹 File type filtering (.txt, .py, .md, etc.)

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables case-insensitive keyword search within files, returning matching lines with their line numbers through a FastAPI-powered interface.

Keyword Search MCP Server

✅ MCP Server – Keyword Search Tool (Case-Insensitive)

📄 Documentation

📁 Project Structure

⚙️ 1. Setup Instructions

✅ Step 1: Clone or Create Project Folder

✅ Step 2: Create and Activate Virtual Environment (Optional but Recommended)

✅ Step 3: Install Dependencies

🚀 2. Run the MCP Server

🔍 3. Search Keyword in a File (API Usage)

✅ Request Format (POST `/search`)

✅ Example using `curl`:

✅ Example Response:

🛠 4. Code Summary

`server.py`

✅ 5. Features

📌 6. Future Improvements (Optional)

New MCP Servers

MCP directory API

✅ MCP Server – Keyword Search Tool (Case-Insensitive)

📄 Documentation

📁 Project Structure

⚙️ 1. Setup Instructions

✅ Step 1: Clone or Create Project Folder

✅ Step 2: Create and Activate Virtual Environment (Optional but Recommended)

✅ Step 3: Install Dependencies

🚀 2. Run the MCP Server

🔍 3. Search Keyword in a File (API Usage)

✅ Request Format (POST /search)

✅ Example using curl:

✅ Example Response:

🛠 4. Code Summary

server.py

✅ 5. Features

📌 6. Future Improvements (Optional)

New MCP Servers

MCP directory API

✅ Request Format (POST `/search`)

✅ Example using `curl`:

`server.py`