Toowiredd Chatgpt MCP Server

🚀 基於Model Context Protocol (MCP) 的 ChatGPT 服務器

本項目是一個基於 Model Context Protocol (MCP) 的服務器，藉助自定義 GPT 接口，實現了 Docker 管理功能，為用戶提供便捷、高效的容器管理體驗。

🚀 快速開始

本服務器可通過自然語言實現 Docker 容器管理，建立在 Model Context Protocol (MCP) 之上，使用 TypeScript 開發，支持容器化部署，具備強大的錯誤處理和優雅關閉功能，資源管理和端口處理能力出色，還提供速率限制和 API 密鑰認證。

✨ 主要特性

• 自然語言管理：通過自然語言實現 Docker 容器管理。
• 先進協議架構：建立在 Model Context Protocol (MCP) 上。
• 技術選型優秀：使用 TypeScript 實現。
• 靈活部署方式：支持容器化部署。
• 穩定運行保障：具備強大的錯誤處理和優雅關閉功能。
• 資源管理高效：資源管理和端口處理能力出色。
• 安全認證機制：提供速率限制和 API 密鑰認證。

📦 安裝指南

克隆代碼庫

git clone https://github.com/toowiredd/chatgpt-mcp-server.git
cd chatgpt-mcp-server

安裝依賴項

npm install

創建環境文件

cp env.example .env
# 根據需要編輯 .env 文件

構建項目

npm run build

💻 使用示例

使用 Docker 運行

構建容器鏡像

npm run docker:build

啟動容器

npm run docker:run

或手動執行：

docker run -d \
  -p 3001:3001 \
  --env-file .env \
  -v /var/run/docker.sock:/var/run/docker.sock \
  chatgpt-mcp-server

📚 詳細文檔

開發指南

• npm run build：構建 TypeScript 代碼。
• npm run watch：即時監聽文件變化並自動重構。
• npm run inspector：運行 MCP 檢查工具。

環境變量配置

資源管理

資源管理功能

該服務器具備強大的資源管理功能：

• 支持信號處理實現優雅關閉（支持 SIGINT、SIGTERM、SIGQUIT）。
• 新連接請求被拒絕後會終止。
• 允許活動中的請求完成並設置超時限制。
• 保持活躍連接存活狀態的管理。
• 跟蹤和釋放服務器端口資源。
• 確保所有資源正確無誤地釋放。

關閉流程

1. 服務器收到關閉信號後，開始執行優雅關閉邏輯。
2. 拒絕新的連接請求。
3. 允許現有請求繼續處理並設置超時。
4. 主動斷開保持連接。
5. 正確釋放佔用的端口資源。
6. 確保所有資源得到妥善處理。

錯誤處理機制

• 監測端口衝突並及時報告。
• 捕捉未處理的拒絕和異常情況。
• 處理網絡傳輸中的錯誤問題。
• 防止資源洩漏，確保正確釋放。
• 設置超時時間避免服務器長時間掛起。