webforai mcp server

Local 2025-09-01 01:08:50 0

A Cloudflare Workers-based server that extracts clean, formatted text from web pages using WebforAI and makes it accessible to AI models through the Model Context Protocol.


A Cloudflare Workers-based Model Context Protocol (MCP) server that extracts plain text from web pages using WebforAI.

? What is WebforAI?

WebforAI is a powerful library designed to make web content accessible to AI models. It provides tools to:

  • Convert HTML to clean, structured Markdown
  • Extract meaningful content from web pages
  • Process tables, links, and images intelligently
  • Prepare web content for AI consumption

This MCP server leverages WebforAI s capabilities to extract plain text from any web page URL, making it easy to feed web content into AI models through the Model Context Protocol.

? Features

  • Simple API: Extract text from any web page with a single API call
  • Clean Output: Receive well-formatted Markdown text without HTML noise
  • Error Handling: Robust error handling for failed requests
  • Cloudflare Workers: Serverless deployment with global distribution
  • MCP Compatible: Works with any MCP client like Claude Desktop or Cloudflare AI Playground

? Getting Started

Deploy to Cloudflare Workers

Deploy to Workers

This will deploy your MCP server to a URL like: webforai-mcp-server.<your-account>.workers.dev/sse

Local Development

  1. Clone this repository:

    git clone https://github.com/yutakobayashidev/webforai-mcp-server.git
    cd webforai-mcp-server

  2. Install dependencies:

    pnpm install

  3. Start the development server:

    pnpm dev

  4. Your server will be available at http://localhost:8787

? Using the Text Extraction Tool

The extractWebPageText tool accepts a URL to a web page and returns the extracted text content in markdown format:

{
  "url": "https://example.com/page"
}

The response will contain the extracted text in Markdown format, with: - Links converted to plain text - Tables converted to plain text - Images hidden

? Connecting to MCP Clients

Cloudflare AI Playground

  1. Go to Cloudflare AI Playground
  2. Enter your deployed MCP server URL (webforai-mcp-server.<your-account>.workers.dev/sse)
  3. You can now use your text extraction tool directly from the playground!

Claude Desktop

To connect to your MCP server from Claude Desktop:

  1. Follow Anthropic s Quickstart
  2. In Claude Desktop go to Settings > Developer > Edit Config
  3. Update with this configuration:
{
  "mcpServers": {
    "webforaiExtractor": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"  // or webforai-mcp-server.your-account.workers.dev/sse
      ]
    }
  }
}
  1. Restart Claude and you should see the text extraction tool become available

? Learn More

? License

MIT