Toto Fetch MCP Server

An MCP server that fetches URL content, converts it to Markdown, and optionally processes it with a local LLM (LaMini-Flan-T5). Returns data in TOON format.

Features

• Fetch & Clean: Fetches HTML, extracts main content using @mozilla/readability, and converts to Markdown with turndown.

• Local AI Processing: Optional local LLM processing using @huggingface/transformers (running Xenova/LaMini-Flan-T5-248M).

• TOON Output: Returns structured data in Token-Oriented Object Notation, optimized for agent consumption.

Installation

npm install

Build

npm run build

Usage

As an MCP Server

Add to your MCP client configuration (e.g., Claude Desktop config):

{
  "mcpServers": {
    "toon-fetch": {
      "command": "npx",
      "args": ["toon-fetch"]
    }
  }
}

Tool: fetch_url

Arguments:

• url (string, required): The URL to fetch.

• prompt (string, optional): Instruction for the local LLM.

  • Example: "Summarize this article"

  • Example: "Extract all dates and events"

  • If omitted, the raw Markdown content is returned.

Output (TOON):

title: Page Title
content: "Markdown content..."
metadata:
  url: "https://example.com"
  excerpt: "..."
  optimized: true

Development

Workflow

1. Install dependencies: npm install

2. Run tests: npm test (uses Vitest)

3. Build: npx tsc

4. Verify: You can use the src/verify.ts script (requires build first or ts-node).

Testing

Run unit tests:

npx vitest

License

MIT