mcpassistant-gateway 0.1.0__tar.gz

mcpassistant_gateway-0.1.0/.gitignore

@@ -0,0 +1,27 @@
+node_modules
+.env
+.env.local
+dist
+*.log
+.DS_Store
+docs/build_log*.txt
+
+# Playwright
+test-results/
+playwright-report/
+report.json
+.last-run.json
+error.txt
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+build/

mcpassistant_gateway-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: mcpassistant-gateway
+Version: 0.1.0
+Summary: Local outbound bridge agent for MCP capability forwarding
+Author: Your Name
+Requires-Python: >=3.11
+Requires-Dist: httpx<1.0.0,>=0.28.1
+Requires-Dist: mcp<2.0.0,>=1.6.0
+Requires-Dist: pyjwt<3.0.0,>=2.10.1
+Requires-Dist: python-dotenv<2.0.0,>=1.0.1
+Requires-Dist: websockets<16.0.0,>=15.0.1
+Description-Content-Type: text/markdown
+
+# mcpassistant-gateway
+
+Async local bridge that connects outbound to the remote MCP bridge over WSS and forwards invoke requests to local MCP servers using the MCP Python client library.
+
+## Run
+
+```bash
+pip install -e .
+mcpassistant-gateway
+```
+
+`mcpassistant-gateway` initializes MCP client sessions for configured `mcpServers` (stdio) and opens the outbound bridge connection to the remote server.
+
+Startup token behavior:
+- If `AGENT_JWT` is already configured (env or `config.json`), startup continues without prompting.
+- If `AGENT_JWT` is missing, the CLI shows a styled prompt and asks you to paste the token.
+- If WebSocket auth fails with `HTTP 403`, the CLI asks for a fresh `AGENT_JWT` and retries immediately.
+- `AGENT_ID` is auto-derived from JWT claims (or token fingerprint fallback), so no manual `AGENT_ID` prompt.
+- Prompted values are saved into resolved `config.json`, so next runs do not ask again.
+
+Set `START_MCP_SERVERS=false` if you only want the bridge process.
+
+Configuration can be provided through `.env` and/or `config.json`.
+
+Minimal dynamic `.env`:
+
+```env
+REMOTE_SERVER_BASE_URL=https://your-remote-domain
+AGENT_JWT=your_agent_jwt
+```
+
+With this mode:
+- `REMOTE_WEBSOCKET_URL` is derived as `wss://.../connect`
+- `AGENT_ID` and `CAPABILITIES` are derived from JWT claims (`sub`, `capabilities`) if not explicitly set
+- Local MCP calls are handled via MCP client sessions for `mcpServers`
+
+## mcpServers + mcpassistant-gateway-bridge
+
+You can run MCP servers from config (supergateway-style) and derive local HTTP endpoints:
+
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "supergateway", "--stdio", "npx", "-y", "@modelcontextprotocol/server-filesystem", "--port", "3004"],
+      "port": 3004
+    }
+  }
+}
+```
+
+Run one server:
+
+```bash
+mcpassistant-gateway-bridge --config ./config.json --name filesystem
+```
+
+Run all servers in config:
+
+```bash
+mcpassistant-gateway-bridge --config ./config.json
+```
+
+

mcpassistant_gateway-0.1.0/README.md

@@ -0,0 +1,65 @@
+# mcpassistant-gateway
+
+Async local bridge that connects outbound to the remote MCP bridge over WSS and forwards invoke requests to local MCP servers using the MCP Python client library.
+
+## Run
+
+```bash
+pip install -e .
+mcpassistant-gateway
+```
+
+`mcpassistant-gateway` initializes MCP client sessions for configured `mcpServers` (stdio) and opens the outbound bridge connection to the remote server.
+
+Startup token behavior:
+- If `AGENT_JWT` is already configured (env or `config.json`), startup continues without prompting.
+- If `AGENT_JWT` is missing, the CLI shows a styled prompt and asks you to paste the token.
+- If WebSocket auth fails with `HTTP 403`, the CLI asks for a fresh `AGENT_JWT` and retries immediately.
+- `AGENT_ID` is auto-derived from JWT claims (or token fingerprint fallback), so no manual `AGENT_ID` prompt.
+- Prompted values are saved into resolved `config.json`, so next runs do not ask again.
+
+Set `START_MCP_SERVERS=false` if you only want the bridge process.
+
+Configuration can be provided through `.env` and/or `config.json`.
+
+Minimal dynamic `.env`:
+
+```env
+REMOTE_SERVER_BASE_URL=https://your-remote-domain
+AGENT_JWT=your_agent_jwt
+```
+
+With this mode:
+- `REMOTE_WEBSOCKET_URL` is derived as `wss://.../connect`
+- `AGENT_ID` and `CAPABILITIES` are derived from JWT claims (`sub`, `capabilities`) if not explicitly set
+- Local MCP calls are handled via MCP client sessions for `mcpServers`
+
+## mcpServers + mcpassistant-gateway-bridge
+
+You can run MCP servers from config (supergateway-style) and derive local HTTP endpoints:
+
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "supergateway", "--stdio", "npx", "-y", "@modelcontextprotocol/server-filesystem", "--port", "3004"],
+      "port": 3004
+    }
+  }
+}
+```
+
+Run one server:
+
+```bash
+mcpassistant-gateway-bridge --config ./config.json --name filesystem
+```
+
+Run all servers in config:
+
+```bash
+mcpassistant-gateway-bridge --config ./config.json
+```
+
+

mcpassistant_gateway-0.1.0/config.json

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": [
+        "@modelcontextprotocol/server-filesystem",
+        "C:/Users/Harish_Mehta/Desktop/my_dirs/workspace/mcp-ts"
+      ]
+    },
+    "windows-mcp": {
+      "command": "uvx",
+      "args": [
+        "windows-mcp"
+      ]
+    }
+  },
+  "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJITkdYR0ZQSjYzIiwicm9sZSI6ImFnZW50IiwiY2FwYWJpbGl0aWVzIjpbIioiXSwiZXhwIjoxNzcyNzI5ODgzfQ.JcsRvhcvR7wS0z2mxWUO1stibQ2DuwK-pJ4WHG0pp9g",
+  "agent_id": "HNGXGFPJ63"
+}

mcpassistant_gateway-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling>=1.25.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcpassistant-gateway"
+version = "0.1.0"
+description = "Local outbound bridge agent for MCP capability forwarding"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Your Name" }]
+dependencies = [
+  "httpx>=0.28.1,<1.0.0",
+  "websockets>=15.0.1,<16.0.0",
+  "python-dotenv>=1.0.1,<2.0.0",
+  "PyJWT>=2.10.1,<3.0.0",
+  "mcp>=1.6.0,<2.0.0",
+]
+
+[project.scripts]
+mcpassistant-gateway = "mcp_local_agent.agent:cli"
+mcpassistant-gateway-bridge = "mcp_local_agent.bridge_server:cli"
+bridgeserver = "mcp_local_agent.bridge_server:cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_local_agent"]
+

mcpassistant_gateway-0.1.0/src/mcp_local_agent/__init__.py

@@ -0,0 +1 @@
+__all__ = ["LocalBridgeAgent", "load_config"]

mcpassistant_gateway-0.1.0/src/mcp_local_agent/__main__.py

@@ -0,0 +1,5 @@
+from .agent import cli
+
+
+if __name__ == "__main__":
+    cli()