Toowiredd Chatgpt MCP Server

🚀 基于Model Context Protocol (MCP) のChatGPTサーバー

このサーバーは、Model Context Protocol (MCP) を基に、カスタムGPTインターフェースを通じてDocker管理機能を提供します。

✨ 主な機能

• 自然言語による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. すべてのリソースが適切に処理されることを確認します。

エラー処理メカニズム

• ポートの競合を監視し、即座に報告します。
• 未処理の拒否と例外を捕捉します。
• ネットワーク伝送中のエラーを処理します。
• リソースのリークを防止し、正しく解放します。
• サーバーが長時間ハングするのを防ぐためにタイムアウトを設定します。