Docker Manager

🚀 ChatGPT MCP 服務器

ChatGPT MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它藉助自定義 GPT 接口，為用戶提供便捷的 Docker 管理功能。

🚀 快速開始

本服務器支持通過 Smithery 自動安裝和手動安裝兩種方式，你可以根據自己的需求進行選擇。

通過 Smithery 安裝

若要通過 Smithery 自動安裝 ChatGPT MCP Server for 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

✨ 主要特性

• 自然語言管理：支持通過自然語言進行 Docker 容器管理，操作更加便捷。
• 基於 MCP 協議：採用 Model Context Protocol (MCP)，確保高效穩定。
• TypeScript 實現：使用 TypeScript 編寫，代碼結構清晰，易於維護。
• 容器化部署：支持容器化部署，方便快捷。
• 強大的錯誤處理：能夠檢測端口衝突、捕獲未處理的拒絕和異常，正確處理網絡錯誤，防止資源洩漏。
• 優雅關閉：在進程信號（SIGINT、SIGTERM、SIGQUIT）上執行優雅關閉，確保資源正確釋放。
• 資源管理：實現了強大的資源管理，包括新連接拒絕、活動請求處理、保持活動連接關閉等。
• 速率限制和認證：支持速率限制和 API 密鑰身份驗證，保障系統安全。

📦 安裝指南

安裝方式分為通過 Smithery 自動安裝和手動安裝，具體步驟見上文“快速開始”部分。

💻 使用示例

開發命令

• npm run build - 構建 TypeScript 代碼
• npm run watch - 監控更改並自動重建
• npm run inspector - 運行 MCP 檢查工具

📚 詳細文檔

環境變量

資源管理

本服務器實現了強大的資源管理，確保在各種情況下都能正確釋放資源。

關閉過程

1. 服務器在進程信號上啟動優雅關閉
2. 新連接被拒絕
3. 活動請求允許完成（帶超時）
4. 保持活動連接被關閉
5. 服務器端口被正確釋放
6. 資源通過適當處理正確釋放

錯誤處理

• 檢測到端口衝突並報告
• 捕獲未處理的拒絕和異常
• 正確處理網絡錯誤
• 通過適當處理防止資源洩漏
• 通過超時確保服務器在關閉期間不會掛起

📄 許可證

本項目採用 MIT 許可證。