JinDaGe - Docker Manager MCP Details

article

README

🚀 ChatGPT MCP 服务器

ChatGPT MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它借助自定义 GPT 接口，为用户提供便捷的 Docker 管理功能。

🚀 快速开始

你可以通过 Smithery 自动安装，也能手动进行安装。安装完成后，可使用 Docker 运行该服务器。

✨ 主要特性

支持通过自然语言进行 Docker 容器管理，操作更加便捷。
基于 Model Context Protocol (MCP) 构建。
使用 TypeScript 实现，保证代码的可维护性和健壮性。
支持容器化部署，方便快捷。
具备强大的错误处理能力和优雅关闭机制。
实现了资源管理和端口处理。
支持速率限制和 API 密钥身份验证，保障系统安全。

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 ChatGPT MCP Server for Claude Desktop，可使用以下命令：

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

手动安装

克隆仓库

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 检查工具

📚 详细文档

环境变量

| 属性 | 详情 | |------|------| | API_KEY | API 认证密钥 | | HTTP_PORT | 服务器端口（默认：3001） | | RATE_LIMIT_REQUESTS | 每窗口的最大请求数 | | RATE_LIMIT_WINDOW | 窗口大小（以毫秒为单位） |

资源管理

该服务器实现了强大的资源管理，具体体现在以下方面：

在进程信号（SIGINT、SIGTERM、SIGQUIT）上执行优雅关闭。
拒绝新连接。
允许活动请求完成（带超时）。
关闭保持活动连接。
正确释放服务器端口。
通过适当处理正确释放资源。

关闭过程

服务器在进程信号上启动优雅关闭。
拒绝新连接。
允许活动请求完成（带超时）。
关闭保持活动连接。
正确释放服务器端口。
通过适当处理正确释放资源。

错误处理

检测到端口冲突并报告。
捕获未处理的拒绝和异常。
正确处理网络错误。
通过适当处理防止资源泄漏。
通过超时确保服务器在关闭期间不会挂起。

📄 许可证

本项目采用 MIT 许可证。

Docker Manager