MCP.so
Sign In
R

Remote MCP Adapter

@aakashh242

Repository

About 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

Basic information

Category

Developer Tools

Transports

stdio

Publisher

aakashh242

Submitted by

Aakash Howlader

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

What are the runtime requirements?

Python 3.12+ and uv for source installation, or Docker Compose for containerized deployment.

What state backends are supported?

In-memory (for development), SQLite (single node), or Redis (multi-node).

How does authentication work?

The adapter uses bearer tokens for clients and supports signed, one-time upload URLs for file staging.

Can it handle multiple upstream servers?

Yes. The adapter supports a multiserver relay, exposing each upstream server under its own path (e.g., /mcp/playwright, /mcp/screenshot).

Comments

More Developer Tools MCP servers

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

Deepwiki MCP Server

regenrek

📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors

1.4K