MCP URL to Text

A Model Context Protocol (MCP) server that converts URLs to text content using the urltoany.com service. This package can be easily deployed via npx for seamless MCP integration.

Features

• Easy Deployment: Install and run via npx without local file management
• URL to Text Conversion: Extract text content from any web URL
• MCP Compatible: Works with any MCP client (Claude, etc.)
• Robust Error Handling: Graceful handling of network issues and API changes
• TypeScript: Built with TypeScript for reliability

Installation

For MCP Users

The package is available on npm and can be used directly in your MCP configuration:

{
  "mcpServers": {
    "url-to-text": {
      "command": "npx",
      "args": ["mcp-url-to-text"]
    }
  }
}

For Developers

npm install mcp-url-to-text

Usage

MCP Configuration

Add this to your MCP configuration file (e.g., ~/.cursor/mcp.json):

{
  "mcpServers": {
    "url-to-text": {
      "command": "npx",
      "args": ["mcp-url-to-text"]
    }
  }
}

Available Tools

The server provides one tool:

• url_to_text: Converts a URL to text content
  • Parameters:
    • url (string, required): The URL to convert to text
  • Returns: Extracted text content from the URL

Example Usage

Once configured, you can use the tool in your MCP client:

Convert the content of https://example.com to text

The tool will:

1. Fetch the webpage
2. Extract readable text content
3. Clean and format the text
4. Return the processed content

Development

Prerequisites

• Node.js 18+
• npm or yarn

Setup

1. Clone the repository
2. Install dependencies: npm install
3. Build the project: npm run build
4. Start development: npm run dev

Scripts

• npm run build - Compile TypeScript to JavaScript
• npm run dev - Run in development mode with tsx
• npm run start - Run the compiled server

Publishing

To publish updates to npm:

1. Update version in package.json
2. Run npm run build
3. Run npm publish

License

MIT License - see LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Support

For issues and questions:

• Create an issue on GitHub
• Check the MCP documentation for general MCP questions