ChatGPT MCP Server

这是一个通过自定义GPT接口提供Docker管理功能的模型上下文协议（MCP）服务器。

特性

• 通过自然语言管理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 \
  chatg
pt-mcp-server

开发

• npm run build - 构建TypeScript代码
• npm run watch - 监控更改并重新构建
• npm run inspector - 运行MCP检查工具

环境变量

• API_KEY - API认证密钥
• HTTP_PORT - 服务器端口（默认：3301）
• RATE_LIMIT_REQUESTS - 每个窗口的最大请求次数
• RATE_LIMIT_WINDOW - 窗口大小（毫秒）

资源管理

该服务器实现了强大的资源管理：

• 在进程信号（SIGINT、SIGTERM、SIGQUIT）时优雅地关闭
• 连接跟踪和管理
• 请求超时处理
• 端口冲突检测
• 保持连接管理
• 主动请求跟踪和优雅完成

关闭过程

1. 服务器在进程信号时启动优雅关闭
2. 拒绝新的连接
3. 允许主动请求完成（带超时）
4. 关闭保持连接
5. 正确释放服务器端口
6. 正确释放资源

错误处理

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

许可证

MIT