MCP Server for Windsurf/Roocode

Windsurf/Roocode MCP 服务

这是一个模型上下文协议（MCP）服务，为 Windsurf 提供图像生成和网页抓取功能。

功能

• 图像生成：使用 Flux Pro 模型生成图像
• 网页抓取：使用 ScrapeGraph 提取网页内容

开始使用

1. 克隆并设置项目：

   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
   

2. 设置环境变量：

   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}"
      }
    }
  }
}

2. 在 Windsurf 中，点击锤子图标并选择“刷新”，以加载 MCP 服务。

使用示例

图像生成

让我们创建一个舒适的 kawaii 客厅！以下是与 Windsurf 的对话示例：

User: Generate a image of a cozy warm living room in kawaii and anime style.

Assistant: I'll help you generate a cozy warm living room image in kawaii and anime style!

[Generated image saved as cozy_kawaii_living_room.png]

User: Try again with an even more cozy and kawaii living room.

Assistant: I'll enhance the kawaii and cozy elements even more in this new version!

[Generated image saved as super_cozy_kawaii_living_room.png]

MCP 服务每次都会生成独特的图像，但会遵循提示词中指定的风格和元素。试着创建自己的舒适空间或其他创意图像吧！

网页抓取

MCP 服务通过 ScrapeGraph API 提供强大的网页抓取功能。以下是主要功能：

1. 内容提取

   # Extract main content from a webpage
   result = await extract_webpage_content(
       url="https://example.com"
   )
   

2. Markdown 转换

   # Convert webpage to clean markdown
   result = await markdownify_webpage(
       url="https://example.com",
       clean_level="medium"  # Options: light, medium, aggressive
   )
   

3. 智能抓取

   # Extract specific information using AI
   result = await scrape_webpage(
       url="https://example.com"
   )
   

功能

• AI 驱动的提取：智能识别并提取主要内容
• 简洁输出：移除广告、导航和其他杂项内容
• 格式选项：获取原始 HTML、Markdown 或结构化数据格式的内容
• 错误处理：提取失败时提供妥善的回退处理
• 自定义：控制清理级别和输出格式

示例用例

1. 文档生成

   # Create local documentation from online sources
   content = await markdownify_webpage(
       url="https://docs.example.com/guide",
       clean_level="medium"
   )
   with open(".docs/guide.md", "w") as f:
       f.write(content)
   

2. 内容分析

   # Extract and analyze webpage sentiment
   content = await extract_webpage_content(
       url="https://example.com/article"
   )
   sentiment = await analyze_text_sentiment(
       text=content["text"]
   )
   

3. 数据收集

   # Extract structured data
   data = await scrape_webpage(
       url="https://example.com/products"
   )
   # Process extracted data
   for item in data["structured_data"]:
       process_item(item)
   

最佳实践

1. 速率限制

   • 遵守网站的速率限制
   • 在请求之间添加延迟
   • 尽可能使用缓存

2. 错误处理

   try:
       content = await extract_webpage_content(url)
   except Exception as e:
       # Fall back to simpler extraction
       content = await markdownify_webpage(url)
   

3. 内容清理

   • 从 "medium" clean_level 开始
   • 对内容非常杂乱的网页使用 "aggressive"
   • 在保留格式很重要时使用 "light"

4. 输出处理

   • 验证提取的内容
   • 处理空结果或部分结果
   • 以适当的方式处理结构化数据

许可证

MIT