ChatGPT MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过自定义 GPT 接口提供 Docker 管理功能。

特性

• 通过自然语言进行 Docker 容器管理
• 构建于模型上下文协议 (MCP) 之上
• TypeScript 实现
• 容器化部署
• 强大的错误处理和优雅关闭
• 资源管理和端口处理
• 速率限制和 API 密钥认证

设置

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 ChatGPT MCP 服务器：

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

环境变量

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

资源管理

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

• 在进程信号 (SIGINT, SIGTERM, SIGQUIT) 上优雅关闭
• 连接跟踪和管理
• 请求超时处理
• 端口冲突检测
• Keep-alive 连接管理
• 活动请求跟踪和优雅完成

关闭过程

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

错误处理

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

许可证

MIT