Chatgpt MCP Server

🚀 ChatGPT MCP 服務器

一個基於模型上下文協議（MCP）的服務器，藉助自定義GPT接口，為用戶提供便捷的Docker容器管理功能，極大提升容器管理的效率與靈活性。

🚀 快速開始

本服務器通過自定義GPT接口，基於模型上下文協議（MCP）提供Docker容器管理功能。你可根據需求選擇合適的安裝方式開啟使用。

✨ 主要特性

• 自然語言管理：支持通過自然語言實現Docker容器管理，操作更便捷。
• 先進協議支持：基於模型上下文協議（MCP）構建。
• 技術選型優質：採用TypeScript實現。
• 部署方式靈活：支持容器化部署。
• 系統穩定性強：具備強大的錯誤處理和優雅關閉機制。
• 資源管理高效：實現資源管理和端口處理。
• 安全機制完善：提供限流和API密鑰認證功能。

📦 安裝指南

使用Smithery自動安裝

通過Smithery可自動安裝ChatGPT MCP Server，供Claude Desktop使用：

npx -y @smithery/cli install @Toowiredd/chatgpt-mcp-server --client claude

手動安裝

1. 克隆倉庫

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

2. 安裝依賴

npm install

3. 創建環境文件

cp env.example .env
# 編輯.env文件以配置您的設置

4. 構建項目

npm run build

使用Docker運行

1. 構建容器鏡像

npm run docker:build

2. 運行容器

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）時執行優雅關閉。
• 連接管理：新連接會被拒絕，活躍請求在超時後完成，保持_alive連接會被關閉。
• 端口與資源釋放：服務器端口能被正確釋放，資源得到妥善處理。

關閉流程

1. 服務器在接收到處理信號時啟動優雅關閉。
2. 拒絕新的連接請求。
3. 允許活躍請求完成（帶超時）。
4. 關閉保持_alive連接。
5. 正確釋放服務器端口。
6. 妥善釋放資源。

錯誤處理

• 能檢測和報告端口衝突。
• 捕獲未捕獲的拒絕和異常。
• 妥善處理網絡錯誤。
• 通過適當處理避免資源洩漏。
• 利用超時機制確保服務器在關閉過程中不會卡頓。

📄 許可證

本項目採用MIT許可證。