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
get_public_google_doc_markdown	Fetches the markdown content of a public Google Doc by URL.	url: string - The public Google Doc URL

Testing the Tools

Run the following command to test the tools:

pnpm dev

FAQ

How to use with Claude Desktop or MCP Clients?

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

{
  "mcpServers": {
    "ireader": {
      "command": "npx",
      "args": ["-y", "@x-mcp/ireader@latest"]
    }
  }
}

or if you want to run the server locally, add the following configuration:

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

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

License

MIT