openroad-mcp

OpenROAD MCP サーバー

OpenROAD および ORFS と連携するためのツールを提供する Model Context Protocol (MCP) サーバーです。

OpenROAD MCP について

初めての方へ クイックスタートガイド を参照して、AI アシスタントが 5 分で設計を解析できるようにしましょう。

OpenROAD MCP は、Claude、Cursor などの MCP 対応クライアントを OpenROAD レイアウトツールに直接接続することで、AI アシスタントと物理設計の間の壁を取り除きます。

OpenROAD は、半導体デジタル設計向けの主要なオープンソースの基盤アプリケーションであり、RTL から GDSII までの自律的な No-Human-In-Loop (NHIL) フローを提供します。OpenROAD-flow-scripts (ORFS) は、それを中心に構築された完全自律型のフローです。

この MCP サーバーを使用すると、AI アシスタントは次のことができます:

• コマンドを実行 - 完全な PTY サポートを備えた対話型 OpenROAD セッションを実行します。
• セッションを管理 - 複数の物理設計セッションを作成、一覧表示、検査、終了します。
• 履歴とメトリクスを追跡 - 完全なコマンド履歴とパフォーマンスメトリクスにアクセスして分析します。
• レポートを可視化 - ORFS 実行のレポート画像をチャット内で直接一覧表示および閲覧します。

デモ

デモ動画の全編を見る

要件とインストール

この MCP サーバーを使用するには、サーバーのランタイムに加えて、基盤となる OpenROAD レイアウトツールが必要です。

1. サーバーランタイム

• npx ディストリビューションを実行するには Node.js 22+ が必要です。

2. OpenROAD

OpenROAD がインストールされ、PATH から利用可能である必要があります。

• OpenROAD 公式インストールガイド

3. OpenROAD-flow-scripts (ORFS)

ORFS はオプションですが、完全な RTL から GDS へのフローとレポートの可視化のために強く推奨されます。

• ORFS 公式ローカルビルドガイド

設定

プラットフォーム固有の Node.js および C++ ツールチェーンのセットアップ手順については、クロスプラットフォームビルドガイド を参照してください。

一般的なケースでは、このリポジトリをクローンしたり、パス環境変数を渡したりする必要は ありません。公開されている npx パッケージは .env ファイルを読み込みません。

起動時に、サーバーは MCP クライアントの環境を継承し、その後 which openroad と同じ方法で PATH を補完します: 現在の PATH、次にログインシェルの PATH、そして一般的なインストール場所 (/opt/homebrew/bin、conda、ローカルの OpenROAD ビルド) です。ORFS_FLOW_PATH のデフォルトは ~/OpenROAD-flow-scripts/flow で、ORFS が openroad バイナリの隣にある場合も検出されます。

対応 MCP クライアント

以下は、ほとんどのクライアントで共通して使用される標準の基本設定です:

{
  "command": "npx",
  "args": ["-y", "openroad-mcp"]
}

正確な設定スニペットとファイルの場所については、以下からお使いのクライアントを探してください。

claude mcp add --transport stdio openroad-mcp -- npx -y openroad-mcp

claude mcp add \
  --env PATH="$(dirname "$(command -v openroad)"):${PATH}" \
  --env ORFS_FLOW_PATH="${HOME}/OpenROAD-flow-scripts/flow" \
  --transport stdio openroad-mcp \
  -- npx -y openroad-mcp

{
  "servers": {
    "openroad-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "openroad-mcp"]
    }
  }
}

{
  "transport": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "openroad-mcp"]
  }
}

{
  "context_servers": {
    "openroad-mcp": {
      "command": {
        "path": "npx",
        "args": ["-y", "openroad-mcp"]
      }
    }
  }
}

docker run --rm -i ghcr.io/the-openroad-project/openroad-mcp:latest

利用可能なツール

設定が完了すると、AI アシスタントは以下のツールにアクセスできるようになります。詳細なパラメータ、スキーマ、戻り値の形式については、API リファレンス を参照してください。

• interactive_openroad_query
• interactive_openroad_exec
• create_interactive_session
• list_interactive_sessions
• terminate_interactive_session
• inspect_interactive_session
• get_session_history
• get_session_metrics
• list_report_images
• read_report_image

トラブルシューティング

• サーバーが起動しない: Node.js 22 以上がインストールされていることを確認してください。古いバージョンでは失敗します。
• セッションの作成に失敗する: ターミナルで command -v openroad が動作することを確認してください。サーバーは PATH を継承し、一般的なインストール場所を検索します。プレフィックスが特殊な場合は、Claude Code のセクションに示すように --env で PATH を渡してください。
• コマンドが CommandBlocked で拒否される: interactive_openroad_query に状態を変更するコマンドを送信しました。代わりに interactive_openroad_exec を使用してください。
• レポート画像が見つからない: サーバーはデフォルトで ~/OpenROAD-flow-scripts/flow を使用します。ORFS が別の場所にある場合は、MCP クライアントの env ブロックで ORFS_FLOW_PATH を設定してください (.env ファイルではありません)。

より詳細な情報を得るには、サーバーの環境で LOG_LEVEL=DEBUG を設定してください。

開発

リポジトリをクローンします。.env.example はローカル開発用の参照専用です。direnv などを使用する場合は .env にコピーしてください。サーバーは依然として (env ファイルではなく) process.env (MCP クライアントの env ブロック) を読み取ります。

次に実行します:

cd typescript
npm install
npm run build

テスト:

npm run test             # unit tests
npm run test:integration # integration tests
npm run test:performance # performance benchmarks

リンティングと型チェック:

npm run typecheck
npm run lint

コントリビューション

コントリビューションを歓迎します! 開発ワークフローとコード標準に関する詳細な手順については、CONTRIBUTING.md を参照してください。

ライセンス

BSD 3-Clause License。LICENSE ファイルを参照してください。

Built with ❤️ by Precision Innovations