返回 MCP 目录
public公开dns本地运行

mcp-server-for-windsurfroocode

一个为Windsurf提供图像生成和网页抓取功能的MCP服务器,支持Flux Pro模型生成图像和ScrapeGraph API进行网页内容提取。

article

README

🚀 MCP 服务器用于 Windsurf/Roocode

这是一个专为 Windsurf 设计的 Model Context Protocol (MCP) 服务器,它具备图像生成和网络抓取两大功能,能为用户带来丰富的使用体验。

✨ 主要特性

  • 图像生成:借助 Flux Pro 模型生成图像。
  • 网络抓取:通过 ScrapeGraph 提取网页内容。

📦 安装指南

克隆并设置项目

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

设置环境变量

cp .env.example .env

接着编辑 .env 文件,添加您的 API 密钥:

AIMLAPI_KEY=your_flux_pro_api_key
SGAI_API_KEY=your_scrapegraph_api_key

🚀 快速开始

MCP 服务器配置

  1. 把以下配置添加到 ~/.codeium/windsurf/mcp_config.json 文件中:
{
  "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}"
      }
    }
  }
}
  1. 在 Windsurf 里,点击锤子图标并选择“刷新”,以此加载 MCP 服务器。

💻 使用示例

图像生成

让我们创建一个舒适的可爱客厅!以下是与 Windsurf 对话的示例:

用户:生成一张温暖舒适的可爱客厅图像,风格为动漫。

助手:我将帮助您生成一张温暖舒适的可爱客厅图像,风格为动漫!

[生成的图像保存为 cozy_kawaii_living_room.png]

舒适的可爱客厅

用户:尝试生成一个更舒适和可爱的客厅。

助手:我会增强这次的可爱和舒适元素!

[生成的图像保存为 super_cozy_kawaii_living_room.png]

超级舒适的可爱客厅

每次 MCP 服务器都会生成独特的图像,但它们会遵循提示中的风格和元素。尝试创建您自己的舒适空间或其他创意图像!

网页抓取

MCP 服务器通过 ScrapeGraph API 提供强大的网页抓取功能。以下是具体用法:

基础用法

# 图像生成示例
from mcp_server import generate_image

# 示例:生成一张猫的图像
image = generate_image("一只猫")
print(image)

# 网页抓取示例
from mcp_server import scrape_website

# 示例:抓取 Wikipedia 页面
content = scrape_website("https://zh.wikipedia.org/wiki/Python_(编程语言)")
print(content)

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端