@diegoaltoworks/localize-remote-mcp-server 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# @diegoaltoworks/localize-remote-mcp-server
|
|
2
|
+
|
|
3
|
+
Proxy a remote HTTP MCP server to localhost.
|
|
4
|
+
|
|
5
|
+
## Why
|
|
6
|
+
|
|
7
|
+
Claude Desktop currently only supports connecting to local MCP servers. If your MCP server is hosted remotely over HTTP, Claude Desktop can't reach it directly. This project bridges that gap — it runs a lightweight local proxy that forwards all MCP traffic to your remote server, letting Claude Desktop (and any other client with the same limitation) work with remote MCP servers as if they were local.
|
|
8
|
+
|
|
9
|
+
## Usage
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npx @diegoaltoworks/localize-remote-mcp-server --port 6969 https://example.com/mcp
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
This starts a local server at `http://localhost:6969/mcp` that proxies all MCP requests to the remote server.
|
|
16
|
+
|
|
17
|
+
## Options
|
|
18
|
+
|
|
19
|
+
| Flag | Description | Default |
|
|
20
|
+
|------|-------------|---------|
|
|
21
|
+
| `-p, --port` | Local port to listen on | `3000` |
|
|
22
|
+
| `-h, --help` | Show help message | |
|
|
23
|
+
|
|
24
|
+
## Example
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
# Proxy a remote MCP server to localhost:6969
|
|
28
|
+
npx @diegoaltoworks/localize-remote-mcp-server --port 6969 https://london-toll-checker.diegoalto.app/mcp
|
|
29
|
+
|
|
30
|
+
# Proxying https://london-toll-checker.diegoalto.app/mcp -> http://localhost:6969/mcp
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Then point your MCP client at `http://localhost:6969/mcp` instead of the remote URL.
|
|
34
|
+
|
|
35
|
+
## What it does
|
|
36
|
+
|
|
37
|
+
- Proxies POST and GET requests to the remote MCP server
|
|
38
|
+
- Streams SSE responses back to the client
|
|
39
|
+
- Forwards authorization headers and MCP session IDs
|
|
40
|
+
- Zero dependencies — just Node.js
|