mcp-server-remote

MCP server that serves a remote MCP client, ready-to-run tools and preset configuration files.

Intended for use within private network for Cybersecurity purposes.

System:  {user} <--> mcp-client-console <--> network <--> {box} <--> mcp-server-remote <--> tools
Server:  mcp-client-console <--> {mcp SDK} <--> * <--> auth.py <--> server.py <--> tools.py

User Guide | Installation

Users:

pipx install mcp-server-remote
mcp-server-remote

Developers:

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 .
mcp-server-remote

User Guide | Configuration

First run creates a default config.toml and prints its filepath (the /config command in the terminal chat prints it too). Edit it — populate with server name, url, token:

[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

User Guide | Operation

Configure the MCP server first, then confirm the MCP client (see repos below) is configured to connect to it. The server accepts the connection, performs the MCP handshake, and lists the available tools to the client.

Configure UNRESTRICTED access in the Config File for the model as desired. Setting unrestricted = true will bypass all [tools.commands] allowed commands. Example

[tools]

unrestricted = true

Only recommended within a sandbox container environment due to prompt injection/model error risk

Related / Required Repos

Project Status

  • Create MCP server repo
  • Connect to MCP client locally
  • Connect to MCP client remotely (over the internet)
  • Connect to MCP server remotely with TLS + bearer auth as requirement
  • Add additional tools to tools.py

Project links

Data verified by PyPI on Aug 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for geomux from gravatar.com geomux

GitHub Statistics

Data verified by PyPI on Aug 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_remote-0.3.6.tar.gz (19.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_remote-0.3.6-py3-none-any.whl (25.8 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_remote-0.3.6.tar.gz.

File metadata

  • Download URL: mcp_server_remote-0.3.6.tar.gz
  • Upload date:
  • Size: 19.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_server_remote-0.3.6.tar.gz
Algorithm Hash digest
SHA256 cfe8e297155d5791cc231b174375a69e436396a2e58f2d0e1752c4f20aaf9182
MD5 7f6ba80eed01301a6564c11b71fe9f7a
BLAKE2b-256 38ca094ec118def91c1a1e2ab3d5624aa845f9304394b0fbe0d89bf15c098106

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_server_remote-0.3.6.tar.gz:

Publisher: publish.yaml on geomux/mcp-server-remote

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_server_remote-0.3.6-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_remote-0.3.6-py3-none-any.whl
Algorithm Hash digest
SHA256 e1c91993e59481224504a57d2111263377e9d83225ae43aa81a9fda339fcc565
MD5 2aadf5d6545d9c332562f90d13e6f62f
BLAKE2b-256 5d276f244a0fcdf02b4e452ca9c9ee55326bc74ecc0027ddf08fc566f4a2ec92

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_server_remote-0.3.6-py3-none-any.whl:

Publisher: publish.yaml on geomux/mcp-server-remote

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page