Skip to main content
Glama
hiroog

mcp-filter-adapter

by hiroog
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

mcp-filter-adapter

UE5 5.8 の MCP サーバーから、画面キャプチャなどの画像を取得できるようにするアダプタ

UE5 5.8 MCP の問題とツールの役割

CaptureViewport 等の Tool 利用時に、画像が text として返ってくるため AI が認識することが出来なくなっています。 またトークンを大量消費し、コンテキストウィンドウが溢れてツールが止まってしまう問題も発生します。

このツールは Client と UE5 MCP Server の間に入り、キャプチャ画像を正しく認識できる形に変換を行います。

Related MCP server: fm-mcp-comfyui-bridge

実際の動作

before（UE5 MCP サーバーの生レスポンス）:

{ "content": [ { "type": "text",
  "text": "{\"returnValue\":{\"image\":{\"mimeType\":\"image/png\",\"data\":\"iVBORw0KG...\"}}}" } ] }

after（このアダプタ通過後）:

{ "content": [
  { "type": "image", "mimeType": "image/png", "data": "iVBORw0KG..." },
  { "type": "text",  "text": "{\"returnValue\": {\"image\": \"<image #0>\", \"cameraFOV\": 90, ...}}" } ] }

使い方

既存の UE5 の mcp 設定を置き換えます。

元の UE5 MCP の設定

{
  "mcpServers": {
    "unreal-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp",
      ]
    }
  }
}

↓ これを以下のように置き換える (<path>/mcp-filter-adapter の部分は clone したフォルダを指定)

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
      	"run",
        "--directory", "<path>/mcp-filter-adapter",
        "mcp-filter-adapter",
        "--upstream", "http://127.0.0.1:8000/mcp"
      ]
    }
  }
}

  1. uv をインストール

  2. このリポジトリを git clone

  3. mcp.json 等に上記エントリを追加

  4. clone したフォルダを --directory で指定

  5. --upstream には UE5 MCP Server の URL を指定

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers