fix: update default host from 127.0.0.1 to localhost

Author: aschlean

README.md

@@ -62,7 +62,7 @@ cd your-project-name
 golf build dev
 golf run
 ```
-This will start the FastMCP server, typically on `http://127.0.0.1:3000` (configurable in `golf.json`).
+This will start the FastMCP server, typically on `http://localhost:3000` (configurable in `golf.json`).
 
 That's it! Your Golf server is running and ready for integration.
 
@@ -133,7 +133,7 @@ The `golf.json` file is the heart of your Golf project configuration. Here's wha
 {
   "name": "{{project_name}}",          // Your MCP server name (required)
   "description": "A Golf project",     // Brief description of your server's purpose
-  "host": "127.0.0.1",                // Server host - use "0.0.0.0" to listen on all interfaces
+  "host": "localhost",                // Server host - use "0.0.0.0" to listen on all interfaces
   "port": 3000,                       // Server port - any available port number
   "transport": "sse",                 // Communication protocol:
                                       // - "sse": Server-Sent Events (recommended for web clients)
@@ -163,7 +163,7 @@ The `golf.json` file is the heart of your Golf project configuration. Here's wha
   - `"sse"` is ideal for web-based clients and real-time communication
   - `"streamable-http"` provides HTTP streaming for traditional API clients
   - `"stdio"` enables integration with command-line tools and scripts
-- **`host` & `port`**: Control where your server listens. Use `"127.0.0.1"` for local development or `"0.0.0.0"` to accept external connections.
+- **`host` & `port`**: Control where your server listens. Use `"localhost"` for local development or `"0.0.0.0"` to accept external connections.
 - **`stateless_http`**: When true, makes the streamable-http transport stateless by creating a new session for each request. This ensures that server restarts don't break existing client connections, making the server truly stateless.
 - **`health_check_enabled`**: When true, enables a health check endpoint for Kubernetes readiness/liveness probes and load balancers
 - **`health_check_path`**: Customizable path for the health check endpoint (defaults to "/health")

src/golf/commands/run.py

@@ -50,7 +50,7 @@ def run_server(
     create_command_header("Starting Server", f"{settings.name}", console)
 
     # Show server info with flashy styling
-    server_host = host or settings.host or "127.0.0.1"
+    server_host = host or settings.host or "localhost"
     server_port = port or settings.port or 3000
 
     server_content = Text()

src/golf/core/builder.py

@@ -858,7 +858,7 @@ def _generate_server(self) -> None:
             "    from rich.panel import Panel",
             "    console = Console()",
             "    # Get configuration from environment variables or use defaults",
-            '    host = os.environ.get("HOST", "127.0.0.1")',
+            '    host = os.environ.get("HOST", "localhost")',
             '    port = int(os.environ.get("PORT", 3000))',
             f'    transport_to_run = "{self.settings.transport}"',
             "",

src/golf/core/builder_auth.py

@@ -12,7 +12,7 @@
 
 def generate_auth_code(
     server_name: str,
-    host: str = "127.0.0.1",
+    host: str = "localhost",
     port: int = 3000,
     https: bool = False,
     opentelemetry_enabled: bool = False,

src/golf/core/config.py

@@ -54,7 +54,7 @@ class Settings(BaseSettings):
     output_dir: str = Field("build", description="Build artifact folder")
 
     # Server settings
-    host: str = Field("127.0.0.1", description="Server host")
+    host: str = Field("localhost", description="Server host")
     port: int = Field(3000, description="Server port")
     transport: str = Field(
         "streamable-http",

tests/conftest.py

@@ -29,7 +29,7 @@ def sample_project(temp_dir: Path) -> Path:
         """{
     "name": "TestProject",
     "description": "A test Golf project",
-    "host": "127.0.0.1",
+    "host": "localhost",
     "port": 3000,
     "transport": "sse"
 }"""

tests/core/test_config.py

@@ -64,7 +64,7 @@ def test_loads_default_settings(self, temp_dir: Path) -> None:
         """Test loading settings with defaults when no config exists."""
         settings = load_settings(temp_dir)
         assert settings.name == "GolfMCP Project"
-        assert settings.host == "127.0.0.1"
+        assert settings.host == "localhost"
         assert settings.port == 3000
         assert settings.transport == "streamable-http"