MCP Server With HTTPS And GitHub OAuth

🚀 ローカル MCP-Server で HTTPS と GitHub OAuth を使用する

このプロジェクトは、Node.js と Express を使用して構築された安全なローカル MCP サーバーです。HTTPS 暗号化（自己署名証明書を使用）、GitHub OAuth 認証、レート制限、HTTP ヘッダー保護などの追加のセキュリティ対策をサポートしています。

✨ 主な機能

• HTTPS 暗号化：クライアントとサーバー間の通信を安全にします。
• GitHub OAuth 認証：ユーザーが GitHub アカウントを使用してログインできるようにします。
• レート制限：乱用やサービス拒否（DoS）攻撃を防止します。
• 安全なセッション管理：express - session と安全なクッキーを使用します。
• HTTP ヘッダー保護：helmet を使用して一般的な脆弱性を保護します。

📦 インストール

前提条件

始める前に、以下がインストールされていることを確認してください。

• Node.js（v16 以上）
• npm（Node.js と一緒に提供されます）
• OpenSSL（SSL 証明書の生成に使用）

手順

ステップ 1：リポジトリをクローンする

このリポジトリをローカルマシンにクローンします。

git clone https://github.com/omar-steam/MCP-Server-with-HTTPS-and-GitHub-OAuth.git
cd mcp-server

ステップ 2：依存関係をインストールする

必要な npm パッケージをインストールします。

npm install

ステップ 3：SSL 証明書を生成する

OpenSSL を使用して自己署名 SSL 証明書を生成します。

openssl genrsa -out key.pem 2048
openssl req -new -key key.pem -out csr.pem
openssl x509 -req -days 365 -in csr.pem -signkey key.pem -out cert.pem

これにより、プロジェクトディレクトリに以下のファイルが作成されます。

• key.pem：秘密鍵
• cert.pem：自己署名証明書

ステップ 4：環境変数を設定する

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を追加します。

CLIENT_ID=your-github-client-id
CLIENT_SECRET=your-github-client-secret
REDIRECT_URI=https://localhost:3000/auth/callback
SESSION_SECRET=your-session-secret

your - github - client - id と your - github - client - secret を、GitHub OAuth App から取得した資格情報に置き換えてください。

ステップ 5：サーバーを起動する

サーバーを実行します。

node server.js

以下の出力が表示されるはずです。

安全なサーバーが https://localhost:3000 で実行されています

💻 使用例

サーバーにアクセスする

ブラウザを開き、以下の URL にアクセスします。

https://localhost:3000

GitHub で認証する

1. /auth にアクセスして GitHub 認証プロセスを開始します。

https://localhost:3000/auth

2. 認証が完了すると、http://localhost:3000/callback にリダイレクトされます。

保護されたルートの使用方法

ターミナルで以下のコマンドを実行して、保護されたルートにアクセスします。

curl -X POST http://localhost:3000/protected --user user:password

📚 ドキュメント

プロジェクト構造

• index.js：メインのサーバーファイルです。
• routes/api.js：API ルートを定義しています。
• public/index.html：テスト用のシンプルな HTML ページです。

トラブルシューティング

ポートが使用中の場合

ポートが使用中の問題が発生した場合は、ポートを変更してみてください。

node server.js 3001

その後、.env ファイルのポート設定を更新してください。

SSL 証明書の警告

コンソールで証明書を受け入れて、HTTPS リンクにアクセスを続けてください。

コントリビューションガイド

どんな貢献も歓迎します！このリポジトリをフォークし、Pull Request を送信する前に [CONTRIBUTING.md](https://github.com/omar - steam/MCP - Server - with - HTTPS - and - GitHub - OAuth/blob/main/CONTRIBUTING.md) を読んでください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。

ありがとう

• Express.js
• Passport.js
• GitHub API

⚠️ 重要提示

your - github - client - id や your - github - client - secret などのプレースホルダーを置き換えてください。 このコードをホストする場合は、リポジトリの URL を更新してください。