Merge pull request #18 from metatool-ai/use-docker-host

Use docker host

Author: zhjch05

README.md

@@ -61,6 +61,16 @@ mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006
 
 With the SSE transport option, the server will start an Express.js web server that listens for SSE connections on the `/sse` endpoint and accepts messages on the `/messages` endpoint.
 
+### Using with Docker
+
+When running the server inside a Docker container and connecting to services on the host machine, use the `--use-docker-host` option to automatically transform localhost URLs:
+
+```bash
+mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006 --use-docker-host
+```
+
+This will transform any localhost or 127.0.0.1 URLs to `host.docker.internal`, allowing the container to properly connect to services running on the host.
+
 ### Command Line Options
 
 ```
@@ -70,13 +80,16 @@ Options:
   --report                      Fetch all MCPs, initialize clients, and report tools to MetaMCP API
   --transport <type>            Transport type to use (stdio or sse) (default: "stdio")
   --port <port>                 Port to use for SSE transport (default: "12006")
+  --require-api-auth            Require API key in SSE URL path
+  --use-docker-host             Transform localhost URLs to use host.docker.internal (can also be set via USE_DOCKER_HOST env var)
   -h, --help                    display help for command
 ```
 
 ## Environment Variables
 
 - `METAMCP_API_KEY`: API key for MetaMCP
 - `METAMCP_API_BASE_URL`: Base URL for MetaMCP API
+- `USE_DOCKER_HOST`: When set to "true", transforms localhost URLs to host.docker.internal for Docker compatibility
 
 ## Development
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamcp/mcp-server-metamcp",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "MCP Server MetaMCP manages all your other MCPs in one MCP.",
   "scripts": {
     "build": "tsc && shx chmod +x dist/*.js",

package.json

@@ -14,6 +14,16 @@ export interface ConnectedClient {
   cleanup: () => Promise<void>;
 }
 
+/**
+ * Transforms localhost URLs to use host.docker.internal when running inside Docker
+ */
+const transformDockerUrl = (url: string): string => {
+  if (process.env.USE_DOCKER_HOST === "true") {
+    return url.replace(/localhost|127\.0\.0\.1/g, "host.docker.internal");
+  }
+  return url;
+};
+
 export const createMetaMcpClient = (
   serverParams: ServerParameters
 ): { client: Client | undefined; transport: Transport | undefined } => {
@@ -30,14 +40,17 @@ export const createMetaMcpClient = (
     };
     transport = new StdioClientTransport(stdioParams);
   } else if (serverParams.type === "SSE" && serverParams.url) {
+    // Transform the URL if USE_DOCKER_HOST is set to "true"
+    const transformedUrl = transformDockerUrl(serverParams.url);
+
     if (!serverParams.oauth_tokens) {
-      transport = new SSEClientTransport(new URL(serverParams.url));
+      transport = new SSEClientTransport(new URL(transformedUrl));
     } else {
       const headers: HeadersInit = {};
       headers[
         "Authorization"
       ] = `Bearer ${serverParams.oauth_tokens.access_token}`;
-      transport = new SSEClientTransport(new URL(serverParams.url), {
+      transport = new SSEClientTransport(new URL(transformedUrl), {
         requestInit: {
           headers,
         },
@@ -54,7 +67,7 @@ export const createMetaMcpClient = (
   const client = new Client(
     {
       name: "MetaMCP",
-      version: "0.4.6",
+      version: "0.5.0",
     },
     {
       capabilities: {

src/client.ts

@@ -27,6 +27,10 @@ program
   .option("--transport <type>", "Transport type to use (stdio or sse)", "stdio")
   .option("--port <port>", "Port to use for SSE transport", "3001")
   .option("--require-api-auth", "Require API key in SSE URL path")
+  .option(
+    "--use-docker-host",
+    "Transform localhost URLs to use host.docker.internal (can also be set via USE_DOCKER_HOST env var)"
+  )
   .parse(process.argv);
 
 const options = program.opts();
@@ -38,6 +42,9 @@ if (options.metamcpApiKey) {
 if (options.metamcpApiBaseUrl) {
   process.env.METAMCP_API_BASE_URL = options.metamcpApiBaseUrl;
 }
+if (options.useDockerHost) {
+  process.env.USE_DOCKER_HOST = "true";
+}
 
 async function main() {
   // If --report flag is set, run the reporting function instead of starting the server

src/index.ts

@@ -40,7 +40,7 @@ export const createServer = async () => {
   const server = new Server(
     {
       name: "MetaMCP",
-      version: "0.4.6",
+      version: "0.5.0",
     },
     {
       capabilities: {