Custommcp

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

本项目将自定义 MCP（Model Control Protocol）与 ChatGPT AI 模板相结合，打造出一个智能代理系统，可实现与 Gmail 和 GitHub 的集成，为用户提供便捷、高效的服务体验。

🚀 快速开始

1. 按照以下步骤完成项目的设置与启动：
   • MCP 服务器设置：
     1. 安装 Python 依赖：

     pip install -r requirements.txt
     

     2. 在 .env 文件中设置环境变量（参考 .env.example）
     3. 运行 MCP 服务器：

     python run.py
     

     4. MCP 服务器将在 http://localhost:8000 可用
   • ChatGPT AI 模板设置：
     1. 切换到 ChatGPT AI 模板目录：

     cd chatgpt-ai-template
     

     2. 安装 Node.js 依赖：

     npm install
     

     3. 运行开发服务器：

     npm run dev
     

     4. ChatGPT AI 模板将在 http://localhost:3000 可用
   • 快速启动（两个服务器一起）： 为方便起见，您可以使用提供的脚本同时启动两个服务器：

./start.sh

此脚本将：

1. 在后台启动 MCP 服务器
2. 等待其初始化
3. 启动 ChatGPT AI 模板前端
4. 当您退出前端时自动停止 MCP 服务器
5. 打开浏览器，导航到 http://localhost:3000。
6. 点击“开始”按钮进入 MCP 控制台。
7. 在控制台中输入并执行命令。

✨ 主要特性

• 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             # 此文件

配置

您需要设置以下 API 凭据：

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

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

📄 许可证

此项目使用 MIT 许可证。