python3 -m venv .venv または 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: OpenClaw MCP Server

MCPサーバーを起動する

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