mcp-python

mrozmen7/mcp-python

3.2

If you are the rightful owner of mcp-python and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

A Model Context Protocol (MCP) server integrating RSS search, YouTube search, and local PDF reading.

Tools
3
Resources
0
Prompts
0

MCP Feed Searcher & PDF Reader

A Model Context Protocol (MCP) server integrating RSS search + YouTube search + local PDF reading.

Overview

This project demonstrates a custom MCP Server built using Python and FastMCP. It gives LLMs (e.g., Claude Desktop) the ability to:

•	🔍 Search FreeCodeCamp news via RSS
•	🎥 Search FreeCodeCamp YouTube videos via RSS
•	📄 Read & extract text from local PDF files
•	🤝 Connect all these tools through a standardized MCP interface

By running this MCP server locally, Claude Desktop can directly access your filesystem and external RSS feeds—safely and in a standardized format.

⸻

Why MCP?

MCP (Model Context Protocol by Anthropic) is a new standard that allows LLMs to connect with external systems in a unified, structured way.

❌ Before MCP

Every LLM needed custom protocols to talk to every API → chaos, duplication, maintenance cost.

✔️ After MCP

A single standardized API between the LLM and your MCP server.

📘 Visual Explanation

  1. What is MCP?
  2. How did MCP emerge?
  3. How MCP works (sequence diagram)

Features

FeatureDescription
📰 RSS News SearchSearch FreeCodeCamp News feed by keyword
📹 YouTube Video SearchSearch FreeCodeCamp YouTube channel videos
📄 PDF ReaderExtract text from local PDFs (first N characters)
🤖 Claude Desktop IntegrationTools appear automatically as MCP tools

📁 Project Structure

MCP-TUTORIAL/

├── docs/ │ └── microsoft.pdf ├── Scenario1/ │ └── feed_mcp.py ├── README.md └── venv/

⚙️ Installation

1️⃣ Clone repository

git clone <your-repo-url>
cd MCP-TUTORIAL/Scenario1

2️⃣ Create virtual environment

python3 -m venv venv

source venv/bin/activate

3️⃣ Install dependencies

Bash

pip install fastmcp feedparser PyPDF2

▶️ Running the MCP Server

Inside Scenario1:

python feed_mcp.py 

## ▶️ Running the MCP Server

Inside `Scenario1`:

```sh
python feed_mcp.py

JSON

 {
  "query": "python",
  "max_results": 3
}

2. YouTube Video Search

Search FreeCodeCamp YouTube videos:

JSON

{
  "query": "javascript",
  "max_results": 2
}

3. PDF Reader

JSON

{
  "path": "docs/microsoft.pdf",
  "max_chars": 2000
}

How Claude Uses Your MCP Tools

When you type a natural request like:

“Read the Microsoft PDF and summarize the first 2 pages.”
Claude automatically converts it into an MCP request:

##JSON

{
  "path": "docs/microsoft.pdf",
  "max_chars": 4000
}

📚 Sources & References