MCP Server Remote
geomux/mcp-server-remote
Servidor MCP remoto com autenticação para expor tools predefinidas
Ver no GitHubServidor MCP que expõe ferramentas e configurações preset para clientes remotos via rede. Funciona com autenticação e permite que aplicações Claude acessem tools pré-configuradas em máquinas locais ou remotas através de protocolo MCP.
Instalação
npx convez-ai geomux/mcp-server-remote1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Conectar Claude a ferramentas em máquinas locais via rede
- Expor APIs e scripts como MCP tools para clientes remotos
- Arquitetura multi-máquina com gateway de MCP
Veredito

Solução robusta para arquitetura distribuída de MCP, focada em exposição remota de tools com autenticação. Ainda em desenvolvimento (conexão remota com TLS pendente), mas viável para ambientes locais/internos.
README
A tradução para o português deste README ainda está na fila.
mcp-server-remote
MCP server that serves a remote MCP client, ready-to-run tools and preset configuration files.
Remote MCP System Architecture Flowchart
{user} <--> mcp-client-console <--> network <--> {box} <--> mcp-server-remote <--> tools
mcp-server-remote Architecture Flowchart
mcp-client-console <--> {mcp SDK} <--> * <--> auth.py <--> server.py <--> tools.py
User Guide | Installation
Users: install commands
:~$ pipx install mcp-server-remote
:~$ mcp-server-remote
Developers: install commands
git clone https://github.com/geomux/mcp-server-remote.git
cd mcp-server-remote
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
User Guide | Configuration
First run will create a default config.toml file and print the filepath to the config file.
Navigate to the filepath, edit the config file- populate with server name, url, token.
The client reads from "config.toml" to configure and define MCP server.
EXAMPLE:
[server]
name = "Box_1" # Label for this machine
host = "127.0.0.1" # IP/Domain for this machine
port = 9000 # Choose port nginx proxies to
path = "/mcp" # Leave this alone. /mcp is default for dependencies.
OS Config Filepath
Linux: ~/.config/mcp-server-remote/config.toml macOS: ~/Library/Application Support/mcp-server-remote/config.toml Windows: %LOCALAPPDATA%\mcp-server-remote\config.toml
/config command may be used to print filepath within the termianl chat.
User Guide | Operation
Configure MCP server first, see related / requires repos below.
Confirm the MCP client is configured to connect to server.
The server connects, performs MCP handshake, lists the available tools to the client.
Related / Required Repos
mcp-client-console
https://github.com/geomux/mcp-client-console
mcp-gateway-remote
https://github.com/geomux/mcp-gateway-remote
--
Project Status
--
- Create MCP server repo
- Connect to MCP client locally
- Add additional tools to Tools.py
- Connect to MCP server remotely with TLS + bearer auth