Robotframeworklibrary To MCP

🚀 Robot Framework ライブラリを MCP サーバーに変換する手順ガイド

このガイドでは、Robot Framework ライブラリを MCP サーバーに変換する具体的な手順を説明します。これにより、MCP プロトコルをサポートするクライアントとのインタラクションが可能になります。

🚀 クイックスタート

手順の説明

1. Robot Framework ライブラリをクローンする
   まず、変換する Robot Framework ライブラリをローカル開発環境にクローンする必要があります。

2. __init__.py ファイルを見つける
   ライブラリのフォルダを開き、__init__.py ファイルを見つけて編集します。このファイルには、通常、Robot Framework の基底クラスから継承されたハイブリッドコアまたはダイナミックコアを使用して、ライブラリクラスが定義されています。

   コード例：

   from robotlibcore import DynamicCore
   class LibraryName(DynamicCore):
       def __init__(self):
           super().__init__()
           # 初期化ロジック
   

3. to_mcp メソッドを追加する
   ライブラリクラスに以下のメソッドを追加して、キーワードを MCP サーバーに公開できるようにします。

   def to_mcp(self):
       from mcp.server.fastmcp import FastMCP
       mcp = FastMCP(self.__class__.__name__)
       for kw in self.keywords.values():
           mcp.add_tool(kw)
       return mcp
   

4. MCP サーバーを起動する
   ライブラリのルートディレクトリに新しい Python ファイル（例：run_server.py）を作成し、以下のコードを追加して MCP サーバーを起動します。

   from src.LibraryName import LibraryName
   
   # ライブラリインスタンスを初期化する
   library_instance = LibraryName()
   # MCP サーバーインスタンスに変換する
   mcp_server = library_instance.to_mcp()
   # 標準入出力トランスポートプロトコルを使用して MCP サーバーを起動する
   mcp_server.run(transport='stdio')
   

MCP クライアントを設定する（VSCode を例とする）

1. MCP サーバーの設定を追加する
   VSCode を開き、Ctrl + Shift + P を押して、コマンドパネルに MCP:Add Server と入力します。

2. JSON 形式で設定する：

   {
       "mcp": {
           "servers": {
               "LibName": {  # サーバーの一意の識別子
                   "type": "stdio",  # 標準入出力トランスポートプロトコルを使用する
                   "command": "uv",  # 実行コマンド（実際の状況に応じて変更）
                   "args": [
                       "--directory",
                       "C:\\somefolder\\ABS Path to The library Root",  # ライブラリの絶対パス
                       "run",
                       "test.py"  # サーバー起動コードを含む Python ファイル名
                   ]
               }
           }
       }
   }
   

実際のケースのデモ

MailClientLibrary を例にとって説明します。

from src.MailClientLibrary import MailClientLibrary 

# メールクライアントライブラリインスタンスを初期化し、必要なパラメータを設定する
mail_client = MailClientLibrary(
    Username="user",
    Password="pass",
    MailServerAddress="127.0.0.1",
    ImapPorts=[993, 143],
    Pop3Ports=[995, 110],
    SmtpPorts=[465, 25]
)

# MCP サーバーインスタンスに変換する
mcp_server = mail_client.to_mcp()

# 標準入出力トランスポートプロトコルを使用して MCP サーバーを起動する
mcp_server.run(transport='stdio')

# MCP サーバーインスタンスを表示する（オプション）
print(mcp_server)

以上の手順に従えば、任意の Robot Framework ライブラリを MCP サーバーに簡単に変換し、MCP プロトコルをサポートするクライアントでインタラクションできます。