mirror of https://github.com/OpenHands/OpenHands.git synced 2025-12-26 05:48:36 +08:00

Update pre-commit hook versions to most recent versions (#8343 )

Co-authored-by: openhands <openhands@all-hands.dev>

2025-05-08 03:59:13 +00:00

3.3 KiB

Raw Blame History

モデルコンテキストプロトコル（MCP）

:::note このページでは、OpenHandsでモデルコンテキストプロトコル（MCP）を設定して使用する方法を説明します。これにより、エージェントの機能をカスタムツールで拡張できます。 :::

概要

モデルコンテキストプロトコル（MCP）は、OpenHandsが外部ツールサーバーと通信するためのメカニズムです。これらのサーバーは、特殊なデータ処理、外部APIアクセス、またはカスタムツールなど、エージェントに追加機能を提供できます。MCPはmodelcontextprotocol.ioで定義されているオープンスタンダードに基づいています。

設定

MCP設定はconfig.tomlファイルの[mcp]セクションで定義されます。

設定例

[mcp]
# SSEサーバー - Server-Sent Eventsを介して通信する外部サーバー
sse_servers = [
    # 基本的なSSEサーバー（URLのみ）
    "http://example.com:8080/mcp",

    # APIキー認証を使用するSSEサーバー
    {url="https://secure-example.com/mcp", api_key="your-api-key"}
]

# Stdioサーバー - 標準入出力を介して通信するローカルプロセス
stdio_servers = [
    # 基本的なstdioサーバー
    {name="fetch", command="uvx", args=["mcp-server-fetch"]},

    # 環境変数を持つstdioサーバー
    {
        name="data-processor",
        command="python",
        args=["-m", "my_mcp_server"],
        env={
            "DEBUG": "true",
            "PORT": "8080"
        }
    }
]

設定オプション

SSEサーバー

SSEサーバーは、文字列URLまたは以下のプロパティを持つオブジェクトを使用して設定されます：

url（必須）
- 型: str
- 説明: SSEサーバーのURL
api_key（オプション）
- 型: str
- デフォルト: None
- 説明: SSEサーバーとの認証用APIキー

Stdioサーバー

Stdioサーバーは、以下のプロパティを持つオブジェクトを使用して設定されます：

name（必須）
- 型: str
- 説明: サーバーの一意の名前
command（必須）
- 型: str
- 説明: サーバーを実行するコマンド
args（オプション）
- 型: list of str
- デフォルト: []
- 説明: サーバーに渡すコマンドライン引数
env（オプション）
- 型: dict of str to str
- デフォルト: {}
- 説明: サーバープロセスに設定する環境変数

MCPの仕組み

OpenHandsが起動すると、次のことが行われます：

config.tomlからMCP設定を読み込む
設定されたSSEサーバーに接続する
設定されたstdioサーバーを起動する
これらのサーバーが提供するツールをエージェントに登録する

エージェントは、これらのツールを組み込みツールと同じように使用できます。エージェントがMCPツールを呼び出すと：

OpenHandsは呼び出しを適切なMCPサーバーにルーティングする
サーバーはリクエストを処理し、レスポンスを返す
OpenHandsはレスポンスを観察結果に変換し、エージェントに提示する

3.3 KiB Raw Blame History Unescape Escape