@mysandbox/ireader_mcp NPM

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

fastmcp zod

1.0.0

7 months ago