Crewai MCP Lab

CrewAI MCP实验室

一系列先进的CrewAI示例和实验，以本地/远程MCP集成为特色。

📂 项目

📖 绘本作家

一个完全自主的代理团队，使用以下工具编写、编辑和插图完整的小说：

• CrewAI：用于代理编排（作家、编辑、插画师、建筑师）。
• LLM支持：支持 开放路由 （GPT-4o、克劳德3等）， Llama.cpp，以及 奥拉玛.
• Comfy用户界面：用于生成字符一致的图像。
• 检索增强生成：为了叙述的连续性。

🎥 YouTube研究员

CrewAI工作流程使用以下工具研究、转录和总结YouTube视频：

• DuckDuckGo MCP：用于查找相关视频。
• yt耳语MCP：用于转录视频内容。
• LLM支持：通过灵活的LLM集成 开放路由 或本地供应商。
• LLM：用于总结成绩单。

🎬 电影分析师

一个分析电影流可用性和关键接收情况的代理团队：

• JustWatch MCP：在意大利查找流媒体服务。
• 勇敢搜索MCP：汇总评论和评级。
• 报告：生成包含调查结果的降价报告。

📈 财务分析师

一个使用实时市场数据进行深度财务分析的多代理团队：

• YFinance MCP：获取股票价格、公司信息和技术指标（RSI、SMA）。
• 多智能体分析：结合数据收集、技术分析和新闻报道。
• 自动报告：生成专业的Markdown投资报告 output/ 文件夹。

📢 营销策略

创建全面营销活动的多模式团队：

• DuckDuckGo MCP：进行实时市场和竞争对手研究。
• LLM战略：开发独特卖点、标语和活动概念。
• ComfyUI MCP：为活动生成视觉概念艺术。

🛠️ 综合设置指南

此项目使用 双层架构:

1. 根静脉：运行CrewAI代理和编排逻辑。
2. MCP Venvs：每个MCP服务器（例如ComfyUI）都在自己的隔离环境中运行，以避免依赖冲突。

1.根环境设置

（磨合 F:\REPOSITORIES\Crewai 根）

# Create Root Virtual Environment
python -m venv venv

# Activate
.\venv\Scripts\activate

# Install Core Dependencies
pip install -r requirements.txt

2.MCP服务器设置

运行以下命令为每个工具准备隔离环境：

# 1. ComfyUI (Local)
cd mcp_servers/comfyui
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
deactivate
cd ../..

# 2. ComfyUI (DGX Spark / Remote)
cd mcp_servers/comfyui-dgspark
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
deactivate
cd ../..

# 3. YouTube Whisper
cd mcp_servers/yt-whisper
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
deactivate
cd ../..

# 4. Simple Datetime (Node.js)
cd mcp_servers/simple-datetime-server
npm install
cd ../..

# 5. YFinance MCP
cd mcp_servers/yfinance_mcp
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
deactivate
cd ../..

3.配置

A.全局MCP配置(crewai_mcp.json)

这个文件告诉CrewAI在哪里可以找到你的工具。

1. 复制 crewai_mcp.template.json 到 crewai_mcp.json.
2. 确保路径指向 本地文件夹 （支持并推荐相对路径）。

- 本地ComfyUI示例： "command": "mcp_servers/comfyui/.venv/Scripts/python.exe" - 远程DGX示例： "command": "mcp_servers/comfyui-dgspark/.venv/Scripts/python.exe"

B.应用程序配置(config.yaml)

1. 导航到 examples/05_illustrated_book_writer/config/.
2. 复制 config.template.yaml 到 config.yaml.
3. 编辑 config.yaml 选择您的个人资料：

   infrastructure:
     # LLM Provider: Choose "openrouter", "llama_cp", "llama_cp_local", or "ollama"
     llm_selected: "openrouter" 
     
     # Image Provider: Choose "local_standard" or "remote_dgspark"
     image_selected: "remote_dgspark" 

C.LLM支持和OpenRouter

该项目针对以下方面进行了优化 开放路由，允许您以最少的设置使用最先进的型号（GPT-4o、Claude 3.5 Sonnet等）。

• 确保您的 OPENAI_API_KEY 在 .env 已设置为您的OpenRouter密钥。
• 配置后，系统会自动处理到OpenRouter端点的路由。

🚀 运行应用程序

关键的：总是从 项目根目录 使用 根静脉.

# 1. Activate Root Venv
.\venv\Scripts\activate

# 2. Run the Illustrated Book Writer
cd examples/05_illustrated_book_writer
python src/main.py

# 3. Run the Financial Analyst
cd examples/08_financial_analyst
python src/main.py

⚡ 远程GPU（DGX Spark）集成

这 comfyui-dgspark MCP服务器自动处理SSH隧道。

1. 先决条件：确保您拥有远程服务器的SSH密钥访问权限。
2. 配置：In config.yaml，选择 image_selected: "remote_dgspark".
3. 操作：该系统将：

- 启动本地MCP包装器。 - 建立SSH隧道（例如，本地8189->远程8188）。 - 向远程ComfyUI实例发送请求。 - 将生成的图像下载回本地计算机。

🧪 测试

要在不运行完整书籍生成的情况下验证架构，请执行以下操作：

DGX火花/远程测试：

python mcp_servers/comfyui-dgspark/TEST/test_crewai_agent_dgspark.py

本地ComfyUI测试：

python mcp_servers/comfyui/TEST/test_crewai_agent.py