Featured image of post Windows(WSL2)でCodex CLIを使ってMCPを使う

Windows(WSL2)でCodex CLIを使ってMCPを使う

Windows(WSL2 Ubuntu24.04)でCodex CLIを使ってRoblox StudioのMCP(studio-rust-mcp-server)と接続します。

Codex CLI が Windows では WSL2 しか対応してない問題

現在 Codex CLI が Windows では WSL2 しかサポートしていません。 なので WSL2 の Ubuntu 24.04 をネットで調べてインストールします。 Codex CLI も以下の deepwiki に聞いてインストールします。

https://deepwiki.com/openai/codex

以下は deepwiki の Codex CLI の MCP 例

~/.codex/config.toml:

1
2
3
[mcp_servers.deepwiki]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.deepwiki.com/sse"]

次のローカル MCP から動かなくなります。

WSL2 ミラーモードのネットワーク

Windows11 22H2 以降でミラーモードというのがあります。

https://learn.microsoft.com/ja-jp/windows/wsl/networking#mirrored-mode-networking

これを使うと http://127.0.0.1:8000 という URL に Windows 側からでも WSL2 の Ubuntu 側からでも接続できるようになります。

以下のように設定します。

C:\Users\<user>\.wslconfig:

1
2
[wsl2]
networkingMode=mirrored

これでネットワーク系のローカル MCP は使えるようになりました。

以下は blender の Codex CLI の MCP 例

~/.codex/config.toml:

1
2
3
[mcp_servers.blender]
command = "uvx"
args = ["blender-mcp"]

WSL2 で stdio 標準入出力の MCP

Roblox Studio を操作する studio-rust-mcp-server という MCP を使いました。 Windows ビルドの実行ファイルを指定したのですが、うまく動きませんでした。

色々試して最終手段で Ubuntu でビルドしたところ動作しました。 使い方は README.md に書きました。

https://github.com/takoyakisoft/studio-rust-mcp-server-wsl2

~/.codex/config.toml:

1
2
3
[mcp_servers.roblox-studio]
command = "rbx-studio-mcp-linux"
args = ["--stdio"]

MCP の stdio を sse に変換する supergateway は Roblox Studio との接続でエラーが出たため諦めました。

おまけ、デフォルトを gpt-5-mini にする

gpt-5 がデフォルトになっていますが、gpt-5-mini でも良く動作します。

~/.codex/config.toml:

1
2
3
4
5
profile = "gpt-5-mini"

[profiles.gpt-5-mini]
model = "gpt-5-mini"
model_reasoning_effort = "high"
Hugo で構築されています。
テーマ StackJimmy によって設計されています。