mcpField
M
Model Context Protocol (MCP) Server ๐Ÿš€

Model Context Protocol (MCP) Server ๐Ÿš€

Local
github.com/praneethk-aiBrowser Automation1Updated 84w ago

About Model Context Protocol (MCP) Server ๐Ÿš€

This Python MCP server brings together research and web-scraping modules for developers and researchers working with current information or website data. Its modular design supports switching between the two modes from an interactive terminal interface.

Key features

  1. 01Research query module
  2. 02Website data scraping module
  3. 03Switch between modules in terminal
  4. 04Logging for monitoring and debugging

Use cases

  1. 01Gather summarized findings for a research query
  2. 02Extract structured data from a specified website

MCP support

Provides research and web-scraping modules through an MCP server, with terminal commands for selecting a mode.

Configuration

Local server config is the same for every client. Copy it into your clientโ€™s MCP config file.

No install method listed yet

We havenโ€™t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Model Context Protocol (MCP) Server ๐Ÿš€

Overview ๐Ÿ“š

image

The Model Context Protocol (MCP) Server is a versatile, modular server designed to handle multiple specialized context-aware tasks. Currently, this implementation includes MCPs for research and web scraping functionalities, making it an ideal foundation for projects requiring automated research or real-time web data extraction.

Purpose & Motivation ๐ŸŽฏ

In today's world, real-time data and reliable research are foundational to informed decision-making. This project provides a centralized, extensible platform to easily integrate specialized functionalities like:

  • Automated Research: Quickly obtain summarized research findings tailored to recent developments and historical context.
  • Web Scraping: Seamlessly scrape and process web data into structured, meaningful information.

The MCP Server offers flexibility, clarity, and expandability, allowing developers and researchers to integrate and scale additional MCP modules as per evolving project requirements.

Features & Functionality โš™๏ธ

Modular Design ๐Ÿ”—
  • Easy integration of new MCP modules.
  • Each MCP module functions independently yet integrates smoothly within the central server.
Specialized MCP Modules ๐ŸŒ
  • ResearchMCP: Provides real-time insights and summarized content related to the user's specified research queries. Incorporates a structured approach to verify and present findings from credible sources.
  • WebscrapingMCP: Automates web data collection, extracting structured content quickly and effectively from specified websites.
Logging & Debugging ๐Ÿ“‹
  • Built-in comprehensive logging capabilities to track system events, debug effectively, and monitor MCP interactions.
User-Friendly Interaction ๐Ÿค–
  • Interactive prompts in the terminal interface for switching MCP modes dynamically.
  • Clear, detailed responses to user requests, enhancing usability and readability.

Technical Stack ๐Ÿ› ๏ธ

  • Python: Core implementation and logic.
  • Argparse: Simplified command-line argument handling.
  • Logging: For detailed logs and debugging information.
  • JSON: Structured data handling and communication.

Installation & Setup โšก๏ธ

Follow these easy steps to set up the MCP server locally:

  1. Clone the repository:
git clone https://github.com/praneethk-ai/praneeths_mcp_server.git
cd MCP_Server
  1. Set up a Python virtual environment and activate it:
python3 -m venv .venv
source .venv/bin/activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Run the server:
python server.py

Usage ๐ŸŽฎ

Upon launching, the MCP Server initializes available protocols. You can dynamically select the MCP you wish to use:

  • Switch to Research MCP:
RESEARCH
  • Switch to Webscraping MCP:
WEBSCRAPING
  • To exit:
exit
Commands
  • switch: Change to a different MCP
  • exit: Exit the server
Commands
  • switch: Change to a different MCP
  • exit: Exit the server

Example Interactions

Research MCP
[RESEARCH MCP] Enter your request: I need information about quantum computing

[RESEARCH MCP]: What specific aspects of this topic are you most interested in?
Your answer: I'm interested in quantum algorithms and their applications

[RESEARCH MCP RESPONSE]: Based on your interest in I need information about quantum computing and your clarification that I'm interested in quantum algorithms and their applications, I've analyzed the available information and found that:

1. This topic has several important aspects worth exploring.
2. Recent developments have changed how experts view this field.

Relevant sources include recent publications by leading researchers and established textbooks in the field.
Webscraping MCP
[WEBSCRAPING MCP] Enter your request: I want to scrape product data from an e-commerce site

[WEBSCRAPING MCP]: What specific website or URL would you like to scrape data from?
Your answer: https://example.com/products

[WEBSCRAPING MCP RESPONSE]: Based on your request to scrape data from https://example.com/products here's how we can approach this:

1. **Web Scraping Approach**:
   - We can use the Requests library with BeautifulSoup for parsing the HTML content.

2. **Data Extraction**:
   - We'll extract the main content based on common HTML patterns and selectors.

3. **Output Format**:
   - The scraped data will be provided in JSON format, which is easily parseable and can be used in various applications.


Project Structure

MCP_Server
โ”‚
โ”œโ”€โ”€ mcp_research.py      # Research MCP Implementation
โ”œโ”€โ”€ mcp_webscraping.py   # Webscraping MCP Implementation
โ”œโ”€โ”€ mcp_server.py        # Core MCP Server
โ”œโ”€โ”€ server.py            # Server execution script
โ”œโ”€โ”€ requirements.txt     # Dependencies list
โ””โ”€โ”€ README.md            # Project documentation

Future Scope ๐ŸŒŸ

This project aims to continually grow by adding additional specialized MCP modules such as:

AI-Driven Analysis Real-Time Data Processing Natural Language Generation Sentiment and Trend Analysis The modular nature encourages innovation and integration of novel functionalities.

Contributing ๐Ÿค

Contributions, enhancements, or feature requests are warmly welcomed! Please open an issue or pull request to start collaborating.

License ๐Ÿ“

This project is licensed under the MIT License โ€” see the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.