iReader MCP logo

iReader MCP

by zlatanpham

iReader MCP is a Model Context Protocol (MCP) server designed to read and extract content from the internet. It provides tools for fetching and processing data from webpages, YouTube videos, tweets, and PDF files.

View on GitHub

Last updated: N/A

iReader MCP

A Model Context Protocol (MCP) server that provides tools for reading and extracting content from internet.

Installation

# Clone the repository
git clone https://github.com/zlatanpham/ireader-mcp.git
cd ireader-mcp

# Install dependencies
pnpm install

Available Tools

| Tool | Description | Parameters | | ------------------------ | --------------------------------------------------- | ------------------------------------------------ | | get_webpage_markdown | Fetches the content of a webpage using Jina reader. | url: string - The URL of the webpage to fetch | | get_youtube_transcript | Fetches the transcript of a YouTube video. | videoURL: string - The YouTube video ID or URL | | get_tweet_thread | Fetches the thread of a tweet. | tweetURL: string - The tweet URL or ID | | get_pdf | Extracts text content from a PDF file. | url: string - The URL of the PDF file |

Running Your Server

Test with mcp-cli

The fastest way to test and debug your server is with fastmcp dev:

pnpm test

This will run your server with mcp-cli for testing and debugging your MCP server in the terminal.

Inspect with MCP Inspector

Another way is to use the official MCP Inspector to inspect your server with a Web UI:

pnpm inspect

FAQ

How to use with Claude Desktop?

Follow the guide https://modelcontextprotocol.io/quickstart/user and add the following configuration:

{
  "mcpServers": {
    "ireader": {
      "command": "npx",
      "args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
      "env": {
        "YOUR_ENV_VAR": "value"
      }
    }
  }
}

The server will start and listen for MCP client connections via stdio.

License

MIT