Skip to content

mrozmen7/mcp-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCP Feed Searcher & PDF Reader

MCP Feed Searcher Banner

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

Feature Description
📰 RSS News Search Search FreeCodeCamp News feed by keyword
📹 YouTube Video Search Search FreeCodeCamp YouTube channel videos
📄 PDF Reader Extract text from local PDFs (first N characters)
🤖 Claude Desktop Integration Tools 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

About

MCP server for RSS, YouTube, and PDF reading

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages