MCP SSE Server and STDIO Server Examples について
本プロジェクトは、ターミナルコマンドを実行する MCP サーバーの構築方法を示すサンプルです。STDIO と SSE の two トランスポートに加え、ローカル Python、Docker、Google Cloud Platform への配備例を含みます。MCP サーバー開発を学ぶ読者向けで、手順は付属の動画チュートリアルに沿っています。
主な機能
- 01ターミナルコマンドを実行する MCP サーバーのサンプル
- 02STDIO と SSE のトランスポート方式を提供
- 03ローカルの Python と Docker での実行に対応
- 04Google Cloud Platform への配備例を収録
活用シーン
- 01MCP サーバーの構築手順の学習
- 02Claude Desktop から簡単なターミナルコマンドを実行
- 03SSE ベースの MCP サーバーをコンテナでクラウドに配備
MCP 対応
本プロジェクトは MCP サーバーであり、ターミナルコマンドの実行機能を MCP クライアントに提供します。例として Claude から ls や echo を実行できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP SSE サーバーと STDIO サーバーの例
はじめに
The AI Language プロジェクトへようこそ!このリポジトリでは、MCP サーバーをセットアップする複数の例を紹介します。MCP(Model Context Protocol)は、AI モデルがデータを保存したり、ツールを実行したり、特定のタスクにプロンプトを使用したりできるフレームワークです。
利用可能なサーバーの例
さまざまな環境で MCP サーバーをセットアップできるよう、4 つの例を用意しています。以下の表に、各構成をまとめています。
| 例 | サーバーの種類 | トランスポート方式 | 環境 | Docker | チュートリアルリンク |
|---|---|---|---|---|---|
| 1 | ターミナルサーバー(STDIO) | STDIO | ローカル | いいえ | チュートリアル 1 |
| 2 | ターミナルサーバー(STDIO) | STDIO | ローカル | はい | チュートリアル 2 |
| 3 | ターミナルサーバー(SSE) | SSE | ローカル | はい | チュートリアル 3 |
| 4 | ターミナルサーバー(SSE) | SSE | Google Cloud Platform(Web) | はい | チュートリアル 3 |
AI、コーディング、自動化について学ぶのがお好きでしたら、チャンネルにいいねとチャンネル登録をお願いします。皆さんの応援が、より良いコンテンツの制作につながります!
チャンネル登録
MCP とは?
**MCP(Model Context Protocol)**は、AI モデルが以下を行えるようにするプロトコルです。
- データを保存する(ファイルや API のレスポンスなど)
- ツールを実行する(AI が実行できる関数)
- プロンプトを使用する(タスク用に事前定義されたテンプレート)
オプション 1:Docker を使わずにセットアップする(ローカルの Python)
このオプションでは、Docker を使わずに Python で MCP サーバーをローカルにセットアップする方法を紹介します。動画チュートリアルをご覧ください:チュートリアル 1
オプション 2:Docker を使ってセットアップする
このオプションでは、Docker で MCP サーバーをコンテナ化し、ローカルで実行する方法を紹介します。動画チュートリアルをご覧ください:チュートリアル 2
オプション 3:SSE を使ってセットアップする(ローカル、Docker)
このオプションでは、ローカル環境で Docker を使い、SSE 経由で MCP サーバーを実行する方法を紹介します。動画チュートリアルをご覧ください:チュートリアル 3
オプション 4:Google Cloud Platform で SSE をセットアップする
このオプションでは、Docker を使って SSE サーバーを Google Cloud Platform にデプロイする方法を説明します。動画チュートリアルをご覧ください:チュートリアル 3
MCP サーバーをテストする
サーバーが起動したら、Claude で次のようなプロンプトを使ってテストできます。
Run the command ls in my workspace.Execute echo Hello from Claude.
ターミナルサーバーからの出力がそのまま表示されます 🎉
まとめ
おめでとうございます!ターミナルコマンドを実行できる MCP サーバーを作成できました。お好みに応じて、ローカルまたは Docker で実行できます。
次のステップ:
- 危険をもたらす可能性のあるコマンドをブロックするセキュリティチェックを追加する。
- Claude がファイルを読み書きできるようにする。
- サーバーをクラウドシステムまたはリモート環境に接続する。
問題や改善案があれば、ぜひこのリポジトリに貢献し、Issue またはプルリクエストを作成してください!
🤝 貢献
現在、このプロジェクトでは外部からのコード貢献を受け付けていません。
これは、ライセンスをシンプルに保ち、著作権の共有を避けるためです。
以下は大歓迎です。
✅ バグの報告や機能のリクエスト(GitHub Issues 経由)
✅ リポジトリをフォークして独自のバージョンを作成
✅ ドキュメント改善の提案
別の方法で協力したい場合は、気軽にディスカッションを開始してください!
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。