convez.ai
MCP ServerDevOps & InfraestruturaAvançado
geomux

MCP Server Remote

geomux/mcp-server-remote

Servidor MCP remoto com autenticação para expor tools predefinidas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-remote

1 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

Estrelas
2
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

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
Ver o original no GitHub

Bom para

Relacionados