Mcp_client_server について
Mcp_client_serverは、GitHub操作と、GitHubのコンテキストを踏まえたOpenAIへの質問に対応するNode.jsのコマンドラインアプリです。対話形式でリポジトリ操作やGitHub関連の質問を行えます。
主な機能
- 01GitHubリポジトリの作成
- 02リポジトリとAPIエンドポイントの一覧表示
- 03GitHubのコンテキストを使ったOpenAIへの質問
- 04対話型コマンドラインインターフェース
- 05環境変数によるAPIキー設定
活用シーン
- 01コマンドラインからのGitHubリポジトリ作成
- 02リポジトリとAPIエンドポイントの一覧確認
- 03GitHubの操作方法の質問
MCP 対応
GitHub MCPサーバーを起動し、そのコンテキストをGitHub操作とOpenAIへの質問に利用します。READMEでは`@modelcontextprotocol/server-github`を使用すると記載されています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
GitHub 用 OpenAI MCP クライアント これは、Model Context Protocol(MCP)サーバーと OpenAI の API を介して GitHub と連携する Node.js のコマンドラインアプリケーションです。ユーザーは GitHub 操作(リポジトリの作成、リポジトリの一覧表示など)を実行したり、MCP サーバーのコンテキストを使用して GitHub 関連の情報を OpenAI に問い合わせたりできます。 機能
GitHub 操作: 新しいリポジトリを作成します。 すべてのリポジトリを一覧表示します。 GitHub API のエンドポイントを一覧表示します。
OpenAI 連携: MCP サーバーの GitHub コンテキストを使って OpenAI に問い合わせ、詳細な回答を得ます(例:「プルリクエストの作成方法」)。
対話型 CLI: コマンドを入力するためのシンプルなコマンドラインインターフェースです。
安全な設定: API キーには環境変数を使用します。
前提条件
Node.js:バージョン 14 以降(推奨:最新の LTS)。 npm:Node.js に付属しています。 GitHub パーソナルアクセストークン:GitHub API へのアクセスに必要です。 OpenAI API キー:OpenAI への問い合わせに必要です。 Git:バージョン管理と GitHub へのプッシュに使用します。
インストール
リポジトリをクローンします: git clone https://github.com/[your-username]/tessst.git cd tessst
依存関係をインストールします: npm install
これにより、axios と dotenv がインストールされます(後述)。
環境変数を設定します:
プロジェクトのルートに .env ファイルを作成します:touch .env
API キーを追加します:OPENAI_API_KEY=your_openai_api_key GITHUB_PERSONAL_ACCESS_TOKEN=your_github_personal_access_token
注意:.env を GitHub にコミットしないでください。.gitignore によって無視されます。
MCP サーバーをインストールします:
このスクリプトは @modelcontextprotocol/server-github を使用します。npx 経由で必要に応じてインストールされるため、追加のセットアップは不要です。
使用方法
アプリケーションを実行します: node openai-mcp-client.js
これにより、対話型 CLI が起動します。
使用可能なコマンド:
新しいリポジトリを作成します:create new repo named my-repo
すべてのリポジトリを一覧表示します:list all repositories
GitHub API のエンドポイントを一覧表示します:list github api
OpenAI に問い合わせます:how to create a pull request
終了します:exit
やり取りの例:
create new repo named test-repo 新しいリポジトリを正常に作成しました:https://github.com/[your-username]/test-repo list all repositories あなたのリポジトリ:
- tessst:MCP クライアント経由で 2025-05-03 に作成されたリポジトリ(https://github.com/[your-username]/tessst)
- test-repo:MCP クライアント経由で 2025-05-03 に作成されたリポジトリ(https://github.com/[your-username]/test-repo)
how to create a pull request OpenAI の回答: GitHub でプルリクエストを作成するには:
- 変更をブランチにプッシュします...
プロジェクト構成
openai-mcp-client.js:CLI と GitHub/OpenAI の処理を含むメインスクリプトです。 .gitignore:node_modules/、.env、ログ、システムファイルを無視します。 .env:API キーを保存します(Git の追跡対象外)。 package.json:依存関係とスクリプトを定義します。
依存関係
axios:GitHub および OpenAI API への HTTP リクエストに使用します。 dotenv:.env から環境変数を読み込むために使用します。
dotenv で package.json を更新するには: npm install dotenv
セキュリティに関する注意事項
API キー:OPENAI_API_KEY と GITHUB_PERSONAL_ACCESS_TOKEN はコードではなく .env に保存してください。 GitHub トークン:repo スコープを指定して https://github.com/settings/tokens でトークンを生成してください。 OpenAI キー:https://platform.openai.com/account/api-keys から取得してください。
トラブルシューティング
"Failed to start GitHub MCP server": GITHUB_PERSONAL_ACCESS_TOKEN が有効で、repo スコープがあることを確認してください。 インターネット接続を確認してください。
"Error querying OpenAI": OPENAI_API_KEY が正しいことを確認してください。
Git 内の node_modules: .gitignore に node_modules/ が含まれていることを確認し、次を実行してください:git rm -r --cached node_modules git commit -m "Remove node_modules"
コマンドが認識されない場合: 正確な表現(例:「create new repo named my-repo」)を使用するか、スクリプトの handleGitHubOperation 関数を確認してください。
貢献
リポジトリをフォークします。 機能ブランチを作成します(git checkout -b feature/your-feature)。 変更をコミットします(git commit -m "Add your feature")。 ブランチにプッシュします(git push origin feature/your-feature)。 プルリクエストを作成します。
ライセンス MIT License。詳細は LICENSE を参照してください。 お問い合わせ 問題や提案がある場合は、GitHub で issue を作成するか、[your-username] に連絡してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。