Toowiredd Chatgpt MCP Server

🚀 基于Model Context Protocol (MCP) 的 ChatGPT 服务器

本项目是一个基于 Model Context Protocol (MCP) 的服务器，借助自定义 GPT 接口，实现了 Docker 管理功能，为用户提供便捷、高效的容器管理体验。

🚀 快速开始

本服务器可通过自然语言实现 Docker 容器管理，建立在 Model Context Protocol (MCP) 之上，使用 TypeScript 开发，支持容器化部署，具备强大的错误处理和优雅关闭功能，资源管理和端口处理能力出色，还提供速率限制和 API 密钥认证。

✨ 主要特性

• 自然语言管理：通过自然语言实现 Docker 容器管理。
• 先进协议架构：建立在 Model Context Protocol (MCP) 上。
• 技术选型优秀：使用 TypeScript 实现。
• 灵活部署方式：支持容器化部署。
• 稳定运行保障：具备强大的错误处理和优雅关闭功能。
• 资源管理高效：资源管理和端口处理能力出色。
• 安全认证机制：提供速率限制和 API 密钥认证。

📦 安装指南

克隆代码库

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

环境变量配置

资源管理

资源管理功能

该服务器具备强大的资源管理功能：

• 支持信号处理实现优雅关闭（支持 SIGINT、SIGTERM、SIGQUIT）。
• 新连接请求被拒绝后会终止。
• 允许活动中的请求完成并设置超时限制。
• 保持活跃连接存活状态的管理。
• 跟踪和释放服务器端口资源。
• 确保所有资源正确无误地释放。

关闭流程

1. 服务器收到关闭信号后，开始执行优雅关闭逻辑。
2. 拒绝新的连接请求。
3. 允许现有请求继续处理并设置超时。
4. 主动断开保持连接。
5. 正确释放占用的端口资源。
6. 确保所有资源得到妥善处理。

错误处理机制

• 监测端口冲突并及时报告。
• 捕捉未处理的拒绝和异常情况。
• 处理网络传输中的错误问题。
• 防止资源泄漏，确保正确释放。
• 设置超时时间避免服务器长时间挂起。