MCP Server for Windsurf/Roocode

基本能力

产品定位

MCP Server 是一个多功能工具，主要用于图像生成和网页内容抓取，适用于需要自动化内容生成和数据提取的开发场景。

核心功能

• 图像生成：使用 Flux Pro 模型生成各种风格的图像，如动漫风格、温馨场景等。
• 网页抓取：通过 ScrapeGraph API 提取网页内容，支持多种格式输出（HTML、Markdown、结构化数据）。

适用场景

1. 内容创作：生成动漫风格图像或其他创意图像。
2. 文档生成：从网页提取内容并转换为本地文档。
3. 数据分析：提取并分析网页内容的情感或结构化数据。
4. 自动化测试：抓取网页内容进行自动化测试或监控。

工具列表

1. Flux Pro 模型：用于图像生成，支持多种风格和主题。
2. ScrapeGraph API：用于网页内容抓取，支持智能提取和格式转换。

常见问题解答

1. 图像生成不一致：每次生成的图像会有所不同，但会遵循提示的风格和元素。
2. 网页抓取失败：建议使用错误处理机制，如回退到简单的提取方法。
3. API 密钥配置：确保在 .env 文件中正确配置 API 密钥。

使用教程

使用依赖

1. 克隆项目并设置虚拟环境： bash 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. 配置环境变量： bash cp .env.example .env 编辑 .env 文件，添加 API 密钥： AIMLAPI_KEY=your_flux_pro_api_key SGAI_API_KEY=your_scrapegraph_api_key

安装教程

1. 配置 MCP Server： 在 ~/.codeium/windsurf/mcp_config.json 中添加以下配置： 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 Server。

调试方式

1. 确保虚拟环境已激活。
2. 检查 .env 文件中的 API 密钥是否正确。
3. 运行以下命令测试服务器： bash python -m app.mcp_server 检查是否有错误输出。

许可证

该项目遵循 MIT 开源许可条款。