Skip to main content
Glama
greenfish-webtools-mcp

greenfish-webtools-mcp

Forks Stargazers Issues GPL License

About The Project

greenfish-webtools-mcp is a Model Context Protocol server that equips AI assistants with live web access. It exposes two tools: web search and URL content extraction.

The key design choice is that this server does not talk to any proprietary search API. Instead, it delegates all search work to your own SearXNG instance — a self-hosted, actively maintained meta-search engine that aggregates results from multiple search providers and exposes a stable JSON API that won't change or be deprecated without notice. You spin up SearXNG, this server connects to it and passes results straight to the model.

greenfish_websearch sends a query to SearXNG and returns a ranked, deduplicated list of results. greenfish_fetch_url fetches a specific page and returns its main readable content, stripped of navigation, ads, and boilerplate using trafilatura.

Related MCP server: noapi-google-search-mcp

Built With

Python SearXNG uv

Getting Started

Before anything else, make sure you have Python 3.10+ and uv installed. You will also need a running SearXNG instance with JSON output enabled. The quickest way to get one is via Docker:

docker run -d --name searxng -p 1818:8080 searxng/searxng

After that, open the SearXNG admin interface, go to Preferences → General, and enable json as an output format. Alternatively, find settings.yml in the SearXNG container and add json to the search.formats list, then restart the container.

Now clone this repository and install the Python dependencies:

git clone https://github.com/DumbGreenFish/GreenFishWebtoolsMCP.git
cd greenfish-webtools-mcp
uv sync

That's it. No API keys, no accounts.

Usage

You can run greenfish-webtools-mcp either as a local stdio MCP server or as a regular HTTP server.

Stdio

Register the server in your MCP client configuration file. The example below works for Claude Desktop and most other clients that accept the standard JSON format:

{
  "mcpServers": {
    "greenfish-webtools": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/greenfish-webtools-mcp",
        "run",
        "app-stdin.py"
      ],
      "env": {
        "SEARXNG_URL": "http://127.0.0.1:1818/search"
      }
    }
  }
}

Replace /path/to/greenfish-webtools-mcp with the actual path to the cloned repository on your machine, and adjust SEARXNG_URL to match the address where your SearXNG instance is running.

HTTP server

Alternatively, you can run the MCP server as a regular HTTP server using app.py:

uv run app.py

By default, the MCP endpoint is available at:

http://localhost:1235/mcp

For MCP clients that support remote HTTP servers, the configuration can look like this:

{
  "mcpServers": {
    "greenfish-webtools": {
      "url": "http://localhost:1235/mcp"
    }
  }
}

Once connected using either method, the AI assistant will have access to greenfish_websearch and greenfish_fetch_url automatically.

Docker

To run the HTTP server with the bundled SearXNG instance, create .env and set SEARXNG_SECRET:

Then start the services with:

docker compose up

If you already have your own SearXNG instance, set SEARXNG_URL in .env to the address of your SearXNG instance and use the plain Compose configuration instead:

docker compose -f docker-compose.plain.yml up

Roadmap

  • Support for additional SearXNG parameters (time range, search categories)

  • Configurable result ranking and deduplication strategy

  • Multi-language documentation

See the open issues for a full list of proposed features and known issues.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also open an issue with the tag "enhancement". Don't forget to give the project a star — thanks!

License

Distributed under the GNU GPLv3 License. See LICENSE for more information.

Contact

Project Link: https://github.com/DumbGreenFish/GreenFishWebtoolsMCP

Acknowledgments

This project would not exist without SearXNG, which does all the actual search work. Thanks also to the authors of FastMCP, trafilatura, and httpx.

Available Tools

2 tools
fetch_urlA
Read-onlyIdempotent

Fetches a web page and returns its main readable content, stripped of navigation, ads and boilerplate. Use this to read the full text of a specific article or documentation page when you already have its URL.

Inputs: params (required). Returns: result

websearchA
Read-onlyIdempotent

Performs a web search and returns the results. This tool allows searching the live web for current information without requiring API keys. It is ideal for retrieving news, documentation, or general facts. Example: Use this tool when you need to find information about recent events or technical documentation.

Inputs: params (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: fetch_url retrieves content from a known URL, while websearch performs a search query. There is no overlap or ambiguity.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern in snake_case: fetch_url and websearch (where 'web' is the noun and 'search' is the verb).

    Tool Count4/5

    With only 2 tools, the server is minimal but still reasonable for a basic web tools utility. It covers the essential functions of searching and fetching, though additional tools like list search results could be useful.

    Completeness4/5

    The server covers the basic web access workflow: search to find URLs, then fetch to read content. Minor gaps exist (e.g., no pagination or result filtering), but core functionality is present.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A lightweight MCP server that enables LLMs to search the web via DuckDuckGo, search GitHub code repositories, and extract clean content from web pages in LLM-friendly formats.
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that enables AI assistants to fetch web content in multiple formats (HTML, JSON, text, Markdown) with intelligent content extraction, chunk management, and browser automation support.
      6
      165 npm
      15
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides browser-grade web access for AI agents, using Chrome's actual network stack to bypass anti-bot protections and return clean markdown.
      9
      -