AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
MCP Servers/
mcp-remote
mcp-remote logo

mcp-remote

Active·★ 1.7k·MIT·Updated 2026-10-20
★ Trending

mcp-remote lets an MCP client that only supports local stdio servers talk to a remote MCP server, including servers that require OAuth. The README's reasoning is that most MCP servers are still installed locally, but the newer MCP authorization specification makes it possible to host servers remotely and share them without everyone running code on their own machine. It describes itself as a working proof of concept and says to treat it as experimental.

Configuration is a standard `mcpServers` entry that runs `npx mcp-remote <server URL>`, used the same way in Claude Desktop, Cursor and Windsurf. Options covered include `--header` for custom or bearer-token headers (with a workaround for clients that mangle spaces in `args`), `--resource` to run several instances of the same server with separate OAuth sessions (for example different Atlassian tenants), adding `-y` or `@latest` to `npx`, a configurable OAuth redirect port, static OAuth client metadata and client information, and transport strategies. It is MIT licensed.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-25.

License
MIT
Latest release
v0.15.2 · 2026-10-20
Last commit
2026-10-20
Contributors
66
Forks
310
Open issues and PRs
2
First published
2025-03-20
npm package
mcp-remote 0.15.2 · 564,091 downloads last week

Source: GitHub, npm and PyPI public APIs.

#mcp#mcp-servers
$ Install
$ npx mcp-remote https://example.remote/server
↗ Visit site★ GitHub
01

Features

01Bridges stdio clients such as Claude Desktop, Cursor and Windsurf to remote servers
02Supports OAuth-based authorization
03Runs with a single npx command in the client config
02

Why choose it

+Solves a common gap: using remote MCP servers from clients that only speak stdio
+Handles the OAuth flow, with options for static client info and a fixed redirect port
+Custom headers and a `--resource` flag for several instances of the same server
+One-line `npx` config that works across Claude Desktop, Cursor and Windsurf
03

Trade-offs

!The README calls it a proof of concept and says to treat it as experimental
!Some clients mangle spaces in `args`, which needs the documented workaround for headers
!Many MCP clients now support remote servers natively, so you may not need it
!It stores OAuth credentials on your machine, so protect that directory
04

Maintenance check

ActiveChecked: 2026-10-23
Last commit
2026-10-20
Commits, last 90 days
98
Releases, last 90 days
30
Latest release
v0.15.2 (2026-10-20)
Open issues
2
Recent issues with at least one comment
14/21
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 0, 0, 19, 45, 1, 18, 4, 1, 0, 0, 6, 2

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #384 [FEATURE REQUEST] Make the listen interface configurable0 comments · 2026-10-23
  • #382 CIMD (DCR) support0 comments · 2026-10-19

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

Claude Desktop
Client
Verified via docs
Cursor
IDE / Editor
Verified via docs
Windsurf
IDE / Editor
Verified via docs
Codex
Client
Verified via docs
Node.js
Runtime
Verified via docs
macOS
OS
Verified via docs
06

Quick start

1
$ npx mcp-remote https://example.remote/server
07

Use cases

↳Use a hosted remote MCP server from a client that lacks remote support
↳Test remote MCP servers with authentication
08

Alternatives

⚡Top VS:
VSofficial-mcp-servers★397→VSjira-skill★89→VSafter-effects-mcp★87→VSaicanvas★68→
official-mcp-servers logo
official-mcp-servers★ 397
A curated directory of 390+ official MCP servers from the companies behind the products. No unofficial forks, no abandoned projects.
VSCompare→
jira-skill logo
jira-skill★ 89
AI agent plugin for Jira — CLI tools for issues, worklogs, sprints, and more | Server/DC & Cloud
VSCompare→
after-effects-mcp logo
after-effects-mcp★ 87
Agent-driven Adobe After Effects automation. MCP server + CEP plugin enabling Codex/Cursor/Claude Code to drive AE through 30 ae.* tools.
VSCompare→
aicanvas logo
aicanvas★ 68
Open-core registry of animated React components, blocks, design systems, and templates. Real, editable code: install with one shadcn CLI command or let your AI agent pull it over MCP.
VSCompare→
kiso logo
kiso★ 51
Kiso is a publishing engine that turns Open Knowledge Format (OKF) bundles into static websites for humans and AI agents. We also provide an MCP Server.
VSCompare→
shipyard-cli logo
shipyard-cli★ 14
The Shipyard CLI and MCP server enable you to manage ephemeral environments from your terminal or from your AI agent.
VSCompare→
telegram-mcp logo
telegram-mcp★ 1.9k
Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.
VSCompare→
Godot-MCP logo
Godot-MCP★ 311
Godot-MCP — Model Context Protocol (MCP) integration for the Godot Engine. AI tools for the Godot Editor in C#, with cloud connection to ai-game.dev. Apache-2.0.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
punkpeye /
mcp-remote
↗

Bridge stdio-only MCP clients to remote MCP servers with OAuth

1.7k310MIT
Last commit1w ago
StatusActive
CategoryMCP Servers
Contributors66
Latest releasev0.15.2
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.