JinDaGe - chatgpt-mcp-server MCP Details

article

README

🚀 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

手动安装

克隆仓库

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）时执行优雅关闭。
连接管理：新连接会被拒绝，活跃请求在超时后完成，保持_alive连接会被关闭。
端口与资源释放：服务器端口能被正确释放，资源得到妥善处理。

关闭流程

服务器在接收到处理信号时启动优雅关闭。
拒绝新的连接请求。
允许活跃请求完成（带超时）。
关闭保持_alive连接。
正确释放服务器端口。
妥善释放资源。

错误处理

能检测和报告端口冲突。
捕获未捕获的拒绝和异常。
妥善处理网络错误。
通过适当处理避免资源泄漏。
利用超时机制确保服务器在关闭过程中不会卡顿。

📄 许可证

本项目采用MIT许可证。

chatgpt-mcp-server