使用说明
自动电子邮件伴侣——开发者自述 概述
此存储库包含两个用于提取和汇总电子邮件的MCP服务：
- mcp1_gmail_extractor——从gmail获取电子邮件，并通过Inspector UI公开工具。
- mcp2_summarizer——总结电子邮件内容，从附件中提取文本，并可以通过YouTube/web链接丰富结果。
快速流动
- 在端口6278上启动MCP2（汇总器）。
- 在端口6277上启动MCP1（Gmail提取器+检查器）。
- 在检查器UI中打开http://127.0.0.1:6277/并运行get_email_details和send_to_mcp2。
- 输出被写入resources/data.json和resources/summary.json。
秘密
将这些文件放在secrets/目录中：
- client_secret.json（谷歌OAuth客户端）——已经存在于MCP1中。
- token.pickle——在第一次OAuth同意后创建（运行test.py或使用Inspector触发OAuth）。
- mcp2.json-可选：包含YOUTUBE_API_KEY和GOOGLE_CX以进行富集。如果缺失，MCP2将运行，但跳过外部富集。
启动命令（PowerShell）
启动MCP2（从repo根目录，或切换到MCP2_summarizer文件夹）：
设置位置”/mcp2_汇总器” ..venv\Scripts\python.exe-m uvicorn mcp2_server:应用程序--端口6278--应用程序目录“\mcp2_汇总器”
启动MCP1（检查器）：
设置位置”/mcp1_gmail_提取器” ..\auto\Scripts\python.exe mcp1_server.py
检查器UI
打开http://127.0.0.1:6277/在浏览器中。检查器列出了用@mcp.tool（）注释的工具。
- 使用get_email_details获取电子邮件并写入resources/data.json。
- 使用send_to_mcp2（或直接POST到mcp2）创建resources/summary.json。
直接HTTP调用MCP2（示例）
将JSON发送到http://127.0.0.1:6278/tools/summarize_context有效载荷如下：
{ “关键字”：[“aws”、“电子邮件”、“无服务器”]， “附件”：[] }
输出
- resources/data.json——由get_email_details创建。
- resources/summary.json——由MCP2汇总器创建。
故障排除
- 缺少令牌：运行test.py或运行get_email_details，并按照OAuth流程创建secrets/Token.pickle。
- 正在使用的端口：运行Get-NetTCPConnection-LocalPort 6278并停止进程-Id 释放它。
- 缺少库（PyPDF2、docx）：使用pip将它们安装到您的venv中。
- 扩展不存在：使用YOUTUBE_API_KEY和GOOGLE_CX添加secrets/mcp2.json，然后重新启动mcp2。
脚本
有一个脚本/文件夹，其中包含用于启动MCP1、MCP2或两者的辅助PowerShell脚本。如果你喜欢一键式方法，请使用这些。
Git：提交和推送
在本地验证所有内容后，提交并推送新文件：
Set-Location "C:\Users\visha\Desktop\automated-email-companion-with-mcp-aws-integration"
git add README.md scripts/start_*.ps1
git commit -m "docs: add README and helper start scripts"
git push origin main
确保您没有从提交敏感文件 secrets/ （client_secret.json，token.pickle）。将它们添加到 .gitignore 如果他们还没有被忽视。
