python3 -m venv .venv or python -m venv .venv source .venv/bin/activate pip install --upgrade pip pip install -r requirements.txt .venv\Scripts\python.exe app.py

ローカル MCP + Groq + OpenAI Agents SDK

この授業用の例には、以下が含まれています：

• app.py: いくつかのツールを備えた、永続的なローカル Streamable HTTP MCP サーバーです。

• mcp_groq_agent.ipynb: それらのツールを検出して呼び出すエージェントです。

セットアップ

Python 3.10 以降を使用してください。ターミナルでこのプロジェクトフォルダーに移動し、 仮想環境を作成して、サーバーとノートブックの両方に必要なものをすべてインストールしてください （必要に応じて python3.11 を、お使いの新しい Python コマンドに置き換えてください）：

cd /Users/somenathmandal/Documents/transfer/grok-playground/MCP
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

例から .env を作成し、その中に Groq API キーを記入してください：

cp .env.example .env

GROQ_API_KEY=replace_with_your_groq_key
GROQ_MODEL=openai/gpt-oss-20b

.env をコミットしたり共有したりしないでください。.gitignore によって除外されています。

Related MCP server: Codex Harness MCP

MCP サーバーを起動する

1 つのターミナルで MCP サーバーを起動し、実行したままにしてください：

source .venv/bin/activate
.venv/bin/python app.py

Streamable HTTP エンドポイントは、次の場所で利用できるようになりました：

http://127.0.0.1:8000/mcp

そのターミナルは開いたままにしてください。サーバーを停止したいときは Ctrl+C を押してください。

エージェントノートブックを実行する

2 つ目のターミナルで：

cd /Users/somenathmandal/Documents/transfer/grok-playground/MCP
source .venv/bin/activate
jupyter lab mcp_groq_agent.ipynb

Jupyter から求められたら .venv の Python カーネルを選択し、セルを上から下へ実行してください。 ノートブックは http://127.0.0.1:8000/mcp に直接接続します。app.py を起動したり インポートしたりすることはありません。Groq API キーは .env から読み込まれ、 ノートブックに保存されることはありません。

各要素の連携

Notebook agent
    -> Groq OpenAI-compatible API (model reasoning and tool selection)
    -> http://127.0.0.1:8000/mcp (tool discovery and execution)
    -> app.py MCP tools

MCP 接続セルを実行する前に、サーバーが起動している必要があります。ノートブックが 接続エラーを報告した場合は、まずサーバーのターミナルで Uvicorn が http://127.0.0.1:8000 で実行中と表示されていることを確認してください。

ノートブックはまた、ノートブックランチャーから偶発的に継承される、古くなった 証明書ファイルの環境変数からも保護します。参照先のパスが存在しない場合にのみ 証明書変数を削除し、有効なカスタム証明書設定は維持されます。

MCP