MCP / Agent 連携¶

この記事では、FIRERPA を大規模モデルと連携させる方法（MCP またはコマンドベース）について説明します。FIRERPA は下層で MCP サーバープロトコルと OpenAI ネイティブの tool call 機能を実装しており、独自の MCP プラグインを作成して標準ポート 65000 でサービスを提供したり、Agent クラスを継承して完全自動の tool 呼び出しを実現したりできます。また、自動化された MCP サービスも組み込みで提供しています。

組み込み Agent コマンド¶

組み込みの agent コマンドを使用すると、大規模モデルを通じて完全に自然な言葉によるタスクをすばやく実行できます。OpenAI API + tool call に対応した任意のサービスプロバイダーまたは自社構築サービスに対応しています。組み込みの crontab と組み合わせることで、自然な言葉によるタスクの定期実行も実現できます。

ヒント

agent コマンドは内蔵端末内で使用する必要があり、有効な API とキーを提供する必要があります。各大規模モデルの動作は異なる場合があるため、最適なものを選択してください。Gemini、OpenAI、DeepSeek、GLM などを推奨します。

パラメータ名	型	必須	デフォルト値	説明
`--api`	文字列 (str)	はい	-	API エンドポイント
`--model`	文字列 (str)	はい	-	モデル名
`--temperature`	浮動小数点数 (float)	いいえ	`0.2`	モデルのサンプリング温度
`--key`	文字列 (str)	はい	-	認証用 API キー
`--vision`	ブール値 (bool)	いいえ	`False`	ビジョンモードを有効にするかどうか
`--imsize`	整数 (int)	いいえ	`1000`	ビジョンモード時の画像サイズ
`--prompt`	文字列 (str)	はい	-	エージェント（Agent）が実行する指示
`--max-tokens`	整数 (int)	いいえ	`16384`	生成する最大トークン数
`--step-delay`	浮動小数点数 (float)	いいえ	`0.0`	ステップ間の遅延時間

注目

注意すべき点として、--api パラメータのアドレスは base_url です。

必要な情報を準備したら、リモートデスクトップの端末で次のコマンドを入力することで、AI にデバイスを自動操作させることができます。

agent --api https://generativelanguage.googleapis.com/v1beta/openai/ --key YOUR_API_KEY --model gemini-2.5-flash --prompt "設定アプリを開いて、パッケージ名 com.android.settings、ネットワーク設定を開き、機内モードをオンにして"

タスクのプロンプトが長すぎる場合は、ファイルでモデルプロンプトを指定することもできます。

agent --api https://generativelanguage.googleapis.com/v1beta/openai/ --key YOUR_API_KEY --model gemini-2.5-flash --prompt /path/to/prompt.txt

Claude & Cursor 連携（MCP）¶

このセクションでは、FIRERPA の MCP 機能を大規模モデルクライアントに接続する方法を説明します。Claude と Cursor を例に説明しますが、MCP プロトコルをサポートする他の任意の場所でも使用できます。

注釈

FIRERPA 内蔵 MCP サービスは、tool call、resource read、prompts、進捗通知、ログをサポートしています。

公式拡張機能の使用¶

Claude の場合、まず Claude 設定ページを開き、図のように操作します。その後、プロンプトに従って Claude の claude_desktop_config.json 設定ファイルを編集し、以下の MCP JSON サービス設定を書き込みます。

{"mcpServers": {"firerpa": {"command": "npx", "args": ["-y", "supergateway", "--streamableHttp", "http://192.168.0.2:65000/mcp/"]}}}

Cursor の場合、Cursor Settings を開き、図のように操作し、以下の設定を入力します。

{"mcpServers": {"firerpa": {"url": "http://192.168.0.2:65000/mcp/"}}}

注目

設定内のアドレスは、ご自身のデバイスの IP アドレスに置き換えてください。

MCP 拡張機能の作成¶

サンプルの MCP プラグインを提供しています。examples/user-home/modules/extension/firerpa.py からダウンロードできます。実装方法を参考にして、プラグインを自作または機能拡張できます。拡張プラグインスクリプトをダウンロードしたら、リモートデスクトップまたは手動 push でデバイスの ~/modules/extension ディレクトリにアップロードし、FIRERPA サービスを再起動してください。FIRERPA の MCP 拡張機能は Python スクリプトとしてデバイスの ~/modules/extension ディレクトリに配置され、サービス再起動後に自動的に読み込まれます。