OpenClawのモデルコンテキストプロトコル(MCP)統合 - MCPサーバーに接続し、OpenClaw内でシームレスにツールを使用する。

概要

このプラグインは、OpenClaw が MCP (Model Context Protocol) サーバーに接続し、ツールを AI エージェントに公開することができます。 MCP ストリーム可能な HTTP トランスポート仕様を実装し、外部 MCP ツールを呼び出すための統一されたインターフェイスを提供します。

✅Real Working Example: 完全な KR-legal-search でテストされたコンフィギュレーション (API キーは必要ありません) で REAL EXAMPLE KR LEGAL.md を参照してください。

主要機能

✅HTTP/SSE Transport - MCP Streamable HTTP for Server-Sent Events のフルサポート ✅Dynamic Tool Discovery - MCPサーバーからツールを自動的に発見し、登録する ✅マルチサーバーサポート - 複数のMCPサーバーに同時に接続 ✅Unified Interface - 単一の[[mcp]ツールを介してアクセス可能なすべてのMCPツール ✅エラー処理 - エラー処理とロギング

受託者

• OpenClaw: バージョン2026.1.0以上
• Node.js:18.0.0以上
• MCPサーバー: MCP-compliant サーバと HTTP トランスポート

OST インストール

方法1:OpenClawエクステンションによる

OpenClaw MCP Integration Plugin

Model Context Protocol (MCP) integration for OpenClaw - Connect to MCP servers and use their tools seamlessly within OpenClaw.

🎯 Overview

This plugin enables OpenClaw to connect to any MCP (Model Context Protocol) server and expose its tools to AI agents. It implements the MCP Streamable HTTP transport specification and provides a unified interface for calling external MCP tools.

✅ Real Working Example: See REAL_EXAMPLE_KR_LEGAL.md for a complete, tested configuration with kr-legal-search (no API key required!).

Key Features

✅ HTTP/SSE Transport - Full support for MCP Streamable HTTP with Server-Sent Events
✅ Dynamic Tool Discovery - Automatically discovers and registers tools from MCP servers
✅ Multi-Server Support - Connect to multiple MCP servers simultaneously
✅ Unified Interface - All MCP tools accessible through a single mcp tool
✅ Error Handling - Robust error handling and logging

📋 Prerequisites

• OpenClaw: Version 2026.1.0 or higher
• Node.js: 18.0.0 or higher
• MCP Server: Any MCP-compliant server with HTTP transport

🚀 Installation

Method 1: Via OpenClaw Extensions

# Clone into OpenClaw extensions directory
cd ~/.openclaw/extensions/
git clone https://github.com/yourorg/mcp-integration.git

# Install dependencies
cd mcp-integration
npm install

# Restart OpenClaw
openclaw gateway restart

Method 2: Manual Installation

# Clone repository
git clone https://github.com/yourorg/mcp-integration.git
cd mcp-integration

# Install dependencies
npm install

# Link to OpenClaw
ln -s $(pwd) ~/.openclaw/extensions/mcp-integration

# Restart OpenClaw
openclaw gateway restart

⚙️ Configuration

Basic Configuration

Add to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "mcp-integration": {
        "enabled": true,
        "config": {
          "enabled": true,
          "servers": {
            "example-server": {
              "enabled": true,
              "transport": "http",
              "url": "http://localhost:3000/mcp"
            }
          }
        }
      }
    }
  }
}

Configuration Schema

{
  enabled: boolean;              // Enable/disable plugin (default: true)
  servers: {
    [serverName: string]: {
      enabled: boolean;          // Enable/disable this server (default: true)
      transport: "http";         // Transport type (currently only http supported)
      url: string;               // Server URL (e.g., "http://localhost:3000/mcp")
    }
  }
}

Multiple Servers Example

{
  "plugins": {
    "entries": {
      "mcp-integration": {
        "enabled": true,
        "config": {
          "enabled": true,
          "servers": {
            "kr-legal": {
              "enabled": true,
              "transport": "http",
              "url": "http://localhost:3000/mcp"