Remote MCP Adapter

@aakashh242

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

aakashh242

提交者

Aakash Howlader

关于 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

Remote MCP Adapter 配置

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

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

Remote MCP Adapter 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,直接连接服务器端点实时获取工具列表。

概览

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.

常见问题

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](https://docs.astral.sh/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`).

开发工具分类下的更多 MCP 服务器

Kaiva Bridge

Kaiva Bridge turns your API, database or documents into a managed MCP server for Claude, ChatGPT, Cursor and VS Code. Point it at an OpenAPI or Swagger spec, an API docs link, a cURL command, a Postman collection, a Grap

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools