Remote MCP Adapter

Name: Remote MCP Adapter
Author: aakashh242

@aakashh242

关于 Remote MCP Adapter

Config-driven MCP proxy that adds session-safe file uploads, artifact handling, and robust state and health controls for upstream MCP servers.

#mcp #remote #streamable-http #ai #agents #llm #central-hosting

基本信息

分类

开发工具

传输方式

stdio

发布者

aakashh242

提交者

Aakash Howlader

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "_comments": "Docker Compose (recommended) - See ReadME at https://github.com/aakashh242/remote-mcp-adapter",
  "mcpServers": {
    "mcpAdapter": {
      "url": "http://localhost:8932/mcp/playwright"
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Remote MCP Adapter?

An MCP gateway that makes remote servers feel local — it manages file uploads to tools and captures generated files back to the client. It sits between your client and upstream MCP servers, staging uploaded files so tools can read them and returning output files as downloadable artifacts, while forwarding everything else unchanged.

How to use Remote MCP Adapter?

Run via Docker Compose (docker compose up on port 8932) or from source with Python 3.12+ and uv (uv run remote-mcp-adapter --config config.yaml). Configure your IDE or agent to point to the adapter's URL (e.g., http://localhost:8932/mcp/playwright) as an HTTP MCP server.

Key features of Remote MCP Adapter

Multiserver relay: expose multiple upstream MCP servers under one gateway.
File uploads via upload:// handles and outputs as artifact:// resources.
Per-session isolation with TTL cleanup and optional revival.
State backends: in-memory, SQLite, or Redis.
Upstream health checks and circuit breaker for resilience.
Bearer token auth and signed one-time upload URLs.

Use cases of Remote MCP Adapter

Run MCP servers in containers or remote machines without a shared filesystem.
Allow tools to read client-side files through staged upload handles.
Capture tool-generated files (screenshots, PDFs) as downloadable MCP artifacts.
Expose multiple upstream MCP servers under one gateway with session isolation.

FAQ from Remote MCP Adapter

What problem does Remote MCP Adapter solve?

It bridges the gap when MCP servers run remotely: tools that read local files can't reach client files, and tools that write files save them on the server where the client can't retrieve them. The adapter stages uploads and captures outputs to solve both issues.