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

sentry-mcp

getsentry

An MCP server for interacting with Sentry via LLMs.

754

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K

Deepwiki MCP Server

regenrek

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

1.4K

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K