Custommcp

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

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

🚀 快速开始

1. 按照以下步骤完成设置：

1. MCP 服务器设置

- 安装 Python 依赖：
```bash
pip install -r requirements.txt
```
- 在 `.env` 文件中设置环境变量（参考 `.env.example`）
- 运行 MCP 服务器：
```bash
python run.py
```
- MCP 服务器将在 `http://localhost:8000` 可用

2. ChatGPT AI 模板设置

- 切换到 ChatGPT AI 模板目录：
```bash
cd chatgpt-ai-template
```
- 安装 Node.js 依赖：
```bash
npm install
```
- 运行开发服务器：
```bash
npm run dev
```
- ChatGPT AI 模板将在 `http://localhost:3000` 可用

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

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

./start.sh

此脚本将：

1. 在后台启动 MCP 服务器

2. 等待其初始化

3. 启动 ChatGPT AI 模板前端

4. 当您退出前端时自动停止 MCP 服务器

5. 使用说明：

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

✨ 主要特性

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

💻 使用示例

基础用法

以下是一些示例用例，展示了该系统的常见使用场景：

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

📚 详细文档

技术栈

项目结构

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 许可证。