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 許可證。