自定义 MCP（模型上下文协议）与 ChatGPT AI 模板项目

此项目结合了自定义 MCP（Model Control Protocol）与 ChatGPT AI 模板，以提供一个智能代理系统，能够与 Gmail 和 GitHub 集成。

功能

• Gmail 集成：读取并分析您的 Gmail 账户中的电子邮件
• GitHub 集成：与 GitHub 仓库交互以检查问题、警告和其他信息
• 智能决策-making：利用 OpenAI 模型决定使用哪些工具以及如何处理信息
• 自主运行：可以自主在不同服务之间导航以完成复杂请求
• 现代 UI：使用 Next.js 和 Chakra UI 构建的美观且响应式界面

示例用例

• "检查我的 Gmail 中是否有 GitHub 警告"
• "查找我仓库中的依赖项警告"
• "总结最近的 GitHub 通知"

技术栈

• 后端：FastAPI（Python）
• AI：OpenAI API
• 外部 API：Gmail API、GitHub API
• 前端：Next.js、React、Chakra UI

项目结构

Custom-MCP/
├── src/                  # MCP 服务器
│   ├── api/              # API 端点
│   ├── services/         # 服务集成（Gmail、GitHub、OpenAI）
│   ├── models/           # 数据模型
│   ├── utils/            # 工具函数
│   ├── config/           # 配置管理
│   └── main.py           # 应用程序入口点
├── chatgpt-ai-template/  # ChatGPT AI 模板
│   ├── app/              # Next.js 应用目录
│   ├── src/              # 源代码
│   ├── public/           # 静态资产
│   └── package.json      # 依赖项
├── .env                  # 环境变量（不在仓库中）
├── .env.example          # 示例环境变量
├── requirements.txt      # Python 依赖项
├── start.sh              # 启动脚本
└── README.md             # 此文件

设置说明

1. MCP 服务器设置

1. 安装 Python 依赖：

   pip install -r requirements.txt
   

2. 在 .env 文件中设置环境变量（参考 .env.example）

3. 运行 MCP 服务器：

   python run.py
   

4. MCP 服务器将在 http://localhost:8000 可用

2. ChatGPT AI 模板设置

1. 切换到 ChatGPT AI 模板目录：

   cd chatgpt-ai-template
   

2. 安装 Node.js 依赖：

   npm install
   

3. 运行开发服务器：

   npm run dev
   

4. ChatGPT AI 模板将在 http://localhost:3000 可用

3. 快速启动（两个服务器一起）

为方便起见，您可以使用提供的脚本同时启动两个服务器：

./start.sh

此脚本将：

1. 在后台启动 MCP 服务器
2. 等待其初始化
3. 启动 ChatGPT AI 模板前端
4. 当您退出前端时自动停止 MCP 服务器

配置

您需要设置以下 API 凭据：

• Gmail API（OAuth2）
• GitHub API（个人访问令牌）
• OpenAI API

参见 .env.example 文件以获取所需环境变量。

使用说明

1. 按照上述说明启动 MCP 服务器和 ChatGPT AI 模板。
2. 打开浏览器，导航到 http://localhost:3000。
3. 点击“开始”按钮进入 MCP 控制台。
4. 在控制台中输入并执行命令。

许可证

此项目使用 MIT 许可证。