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许可证。