Custom MCP (Model Context Protocol) with ChatGPT AI Template

基于 ChatGPT AI Template 的自定义 MCP（Model Context Protocol）

本项目将自定义 MCP（Model Control Protocol）与 ChatGPT AI Template 集成，提供一个可与 Gmail 和 GitHub 集成的智能 Agent 系统。

功能

• Gmail 集成：读取并分析 Gmail 帐户中的邮件
• GitHub 集成：与 GitHub 仓库交互，检查问题、提醒及其他信息
• 智能决策：使用 OpenAI 模型决定使用哪些工具以及如何处理信息
• 自主运行：可在不同服务间自主切换，以完成复杂请求
• 现代化 UI：使用 Next.js 和 Chakra UI 构建的精美响应式 UI

使用示例

• “检查我的 Gmail 中是否有 GitHub 警告”
• “查找我仓库的依赖项提醒”
• “总结近期的 GitHub 通知”

技术栈

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

项目结构

Custom-MCP/
├── src/                  # MCP Server
│   ├── api/              # API endpoints
│   ├── services/         # Service integrations (Gmail, GitHub, OpenAI)
│   ├── models/           # Data models
│   ├── utils/            # Utility functions
│   ├── config/           # Configuration management
│   └── main.py           # Application entry point
├── chatgpt-ai-template/  # ChatGPT AI Template
│   ├── app/              # Next.js app directory
│   ├── src/              # Source code
│   ├── public/           # Static assets
│   └── package.json      # Dependencies
├── .env                  # Environment variables (not in repo)
├── .env.example          # Example environment variables
├── requirements.txt      # Python dependencies
├── start.sh              # Script to start both servers
└── README.md             # This file

设置说明

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 Template 设置

1. 进入 ChatGPT AI Template 目录：

   cd chatgpt-ai-template
   

2. 安装 Node.js 依赖项：

   npm install
   

3. 运行开发服务器：

   npm run dev
   

4. ChatGPT AI Template 将在 http://localhost:3000 上提供

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

为方便起见，你可以使用提供的脚本一次启动两个服务：

./start.sh

此脚本将：

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

配置

你需要设置以下 API 凭据：

• Gmail API（OAuth2）
• GitHub API（Personal Access Token）
• OpenAI API

所需的环境变量请参见 .env.example 文件。

使用方法

1. 按照上述说明启动 MCP 服务和 ChatGPT AI Template。
2. 打开浏览器并访问 http://localhost:3000。
3. 点击侧边栏中的 “MCP Chat” 选项，进入 MCP Chat 界面。
4. 在输入框中输入查询，然后按 Enter 或点击 Send 按钮。
5. MCP 服务将处理你的查询并返回响应。

许可证

MIT