MCP Website Fetcher

# MCP Website Fetcher <!-- markdown-link-check-disable-next-line --> [](https://opensource.org/licenses/Apache-2.0) [](https://github.com/marketplace/actions/super-linter) <!-- markdown-link-check-disable-next-line -->  [](https://github.com/boyter/scc/) [](https://github.com/boyter/scc/) Model Context Protocol (MCP) Website Fetcher is a lightweight MCP server implementation that provides a simple tool for fetching website content. It serves as a demonstration project to show how tools can be exposed and interacted with using the MCP protocol. ## Overview This project exposes an MCP-compatible API endpoint with a tool called `fetch` that allows clients to retrieve the raw content of a specified URL. It's designed mainly for demo purposes and testing how clients can interact with tools over the MCP protocol. ## Running the Server Using Docker The application is automatically built and pushed to GitHub Container Registry (GHCR) on every push to the main branch. To run the latest version locally using Docker: ```bash docker run -d -p 8000:8000 ghcr.io/electrocucaracha/mcp-website-fetcher:main ``` > This will start the MCP server and expose it on port 8000. ## How to setup a development environment This project includes **Dev Container** support, making it easy to get started with a fully configured development environment. This ensures consistency across development setups and allows contributors to begin working without manual environment configuration. ### Option 1: GitHub Codespaces You can launch a cloud-based development environment instantly: [](https://github.com/codespaces/new?repo=electrocucaracha/mcp-website-fetcher) ### Option 2: Local Dev Container (Visual Studio Code) 1. Install [Visual Studio Code](https://code.visualstudio.com/). 1. Install the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers). 1. Ensure you have a container runtime installed and running: - [Docker Desktop](https://www.docker.com/products/docker-desktop/) (Windows/macOS) - [Docker Engine](https://docs.docker.com/engine/install/) or [Podman](https://podman.io/) (Linux) 1. Open this repository in Visual Studio Code. 1. When prompted, reopen the project in a Dev Container. ## Testing Locally Once the container is running, you can interact with the server using `curl` to test its capabilities. ### Get the List of Tools To retrieve the list of available tools exposed by the MCP server: ```bash curl -H "Accept: application/json, text/event-stream" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list"}' \ http://127.0.0.1:8000/mcp ``` ### Fetch the Content of a Website To fetch the content of `https://electrocucaracha.com/`: ```bash curl -H "Accept: application/json, text/event-stream" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "fetch", "arguments": { "url": "https://electrocucaracha.com/" }}}' \ http://127.0.0.1:8000/mcp ``` > The server will return the HTML content of the requested URL.