home / mcp / bananabit windsurf mcp server

BananaBit Windsurf MCP Server

Provides image generation via Flux Pro and web scraping via ScrapeGraph for Windsurf integration.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bananabit-dev-mcp": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "AIMLAPI_KEY": "sk-...",
        "SGAI_API_KEY": "sgai-..."
      }
    }
  }
}

This MCP server provides image generation using the Flux Pro model and web scraping capabilities via ScrapeGraph, allowing you to generate images on demand and extract clean content from web pages for research, documentation, or data collection.

How to use

You will run a local MCP server and connect to it with an MCP client (such as Windsurf). Use the server to generate images by sending prompts that describe the scene you want, and to perform web scraping tasks to pull main content or clean, structured data from web pages.

How to install

Prerequisites: you need Python and a virtual environment tool installed on your system.

Clone the project, create and activate a virtual environment, then install dependencies.

Set up environment variables by copying the example file and editing it to include your API keys.

git clone https://github.com/bananabit-dev/mcp.git
cd mcp
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

Additional sections

Configuration and startup steps are provided to run the MCP server in your environment. You will configure a local MCP server entry with the exact command, working directory, and environment variables shown.

Environment variables you need to set (at minimum) are the API keys for Flux Pro and ScrapeGraph.

{
  "mcpServers": {
    "bananabit-mcp": {
      "command": "/absolute/path/to/your/.venv/bin/python",
      "args": ["-m", "app.mcp_server"],
      "cwd": "/absolute/path/to/mcp",
      "env": {
        "PYTHONPATH": "/absolute/path/to/mcp",
        "AIMLAPI_KEY": "${env:AIMLAPI_KEY}",
        "SGAI_API_KEY": "${env:SGAI_API_KEY}"
      }
    }
  }
}

Notes on environment variables and keys

The following keys are used by the MCP server to access image generation and web scraping capabilities. Keep these keys secure and do not expose them publicly.

AIMLAPI_KEY corresponds to your Flux Pro API key and SGAI_API_KEY corresponds to your ScrapeGraph API key.

Usage examples for image generation and scraping

Image generation examples let you request visuals in specified styles. The server will produce a unique image for each request while honoring the described style and elements.

Web scraping examples show how to extract main content, convert pages to markdown, or retrieve structured data using AI-powered extraction.

Available tools

generate_image

Generates an image based on a text prompt using Flux Pro model.

extract_webpage_content

Extracts the main content from a webpage, returning clean text.

markdownify_webpage

Converts a webpage to clean markdown with configurable cleaning levels.

scrape_webpage

Performs AI-powered scraping to extract structured data from a webpage.