What is Chatgpt Mcp Server

chatgpt-mcp-server is a Model Context Protocol server designed for managing Docker containers through a custom GPT interface, allowing users to interact with Docker using natural language.

Use cases

Use cases include automating Docker container deployments, managing container lifecycles through conversational interfaces, integrating with CI/CD pipelines, and simplifying Docker management for developers and system administrators.

How to use

To use chatgpt-mcp-server, you can install it via Smithery or manually by cloning the repository, installing dependencies, configuring environment variables, and building the project. You can then run it using Docker commands.

Key features

Key features include natural language Docker container management, TypeScript implementation, containerized deployment, robust error handling, resource management, port handling, rate limiting, and API key authentication.

Where to use

chatgpt-mcp-server can be used in various fields such as DevOps, cloud computing, software development, and any environment where Docker container management is required.

ChatGPT MCP Server

A Model Context Protocol (MCP) server that provides Docker management capabilities through a custom GPT interface.

Features

• Docker container management through natural language
• Built on the Model Context Protocol (MCP)
• TypeScript implementation
• Containerized deployment
• Robust error handling and graceful shutdown
• Resource management and port handling
• Rate limiting and API key authentication

Setup

Installing via Smithery

To install ChatGPT MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Toowiredd/chatgpt-mcp-server --client claude

Manual Installation

1. Clone the repository

git clone https://github.com/toowiredd/chatgpt-mcp-server.git
cd chatgpt-mcp-server

2. Install dependencies

npm install

3. Create environment file

cp env.example .env
# Edit .env with your configuration

4. Build the project

npm run build

Running with Docker

1. Build the container

npm run docker:build

2. Run the container

npm run docker:run

Or manually:

docker run -d \
  -p 3001:3001 \
  --env-file .env \
  -v /var/run/docker.sock:/var/run/docker.sock \
  chatgpt-mcp-server

Development

• npm run build - Build the TypeScript code
• npm run watch - Watch for changes and rebuild
• npm run inspector - Run the MCP inspector tool

Environment Variables

• API_KEY - API authentication key
• HTTP_PORT - Server port (default: 3001)
• RATE_LIMIT_REQUESTS - Maximum requests per window
• RATE_LIMIT_WINDOW - Window size in milliseconds

Resource Management

The server implements robust resource management:

• Graceful shutdown on process signals (SIGINT, SIGTERM, SIGQUIT)
• Connection tracking and management
• Request timeout handling
• Port conflict detection
• Keep-alive connection management
• Active request tracking and graceful completion

Shutdown Process

1. The server initiates graceful shutdown on process signals
2. New connections are rejected
3. Active requests are allowed to complete (with timeout)
4. Keep-alive connections are closed
5. Server ports are properly released
6. Resources are properly released

Error Handling

• Port conflicts are detected and reported
• Unhandled rejections and exceptions are caught
• Network errors are properly handled
• Resource leaks are prevented through proper handling
• Timeouts ensure the server doesn’t hang during shutdown

License

MIT