feat(mcp): implement http transport support

Author: stickerdaniel

.vscode/tasks.json

@@ -68,6 +68,36 @@
             },
             "problemMatcher": []
         },
+        {
+            "label": "uv run main.py --transport streamable-http --no-setup",
+            "detail": "Start HTTP MCP server on localhost:8000/mcp",
+            "type": "shell",
+            "command": "uv",
+            "args": [
+                "run",
+                "main.py",
+                "--transport",
+                "streamable-http",
+                "--host",
+                "127.0.0.1",
+                "--port",
+                "8000",
+                "--path",
+                "/mcp",
+                "--no-setup"
+            ],
+            "isBackground": true,
+            "group": {
+                "kind": "build",
+                "isDefault": false
+            },
+            "presentation": {
+                "reveal": "always",
+                "panel": "new",
+                "focus": true
+            },
+            "problemMatcher": []
+        },
         {
             "label": "uv run tail -n 20 -F ~/Library/Logs/Claude/mcp*.log",
             "detail": "Follow Claude Desktop logs",

linkedin_mcp_server/config/loaders.py

@@ -80,9 +80,30 @@ def load_from_args(config: AppConfig) -> AppConfig:
 
     parser.add_argument(
         "--transport",
-        choices=["stdio", "sse"],
+        choices=["stdio", "streamable-http"],
         default=None,
-        help="Specify the transport mode (stdio or sse)",
+        help="Specify the transport mode (stdio or streamable-http)",
+    )
+
+    parser.add_argument(
+        "--host",
+        type=str,
+        default=None,
+        help="HTTP server host (default: 127.0.0.1)",
+    )
+
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=None,
+        help="HTTP server port (default: 8000)",
+    )
+
+    parser.add_argument(
+        "--path",
+        type=str,
+        default=None,
+        help="HTTP server path (default: /mcp)",
     )
 
     parser.add_argument(
@@ -109,6 +130,15 @@ def load_from_args(config: AppConfig) -> AppConfig:
     if args.transport:
         config.server.transport = args.transport
 
+    if args.host:
+        config.server.host = args.host
+
+    if args.port:
+        config.server.port = args.port
+
+    if args.path:
+        config.server.path = args.path
+
     if args.chromedriver:
         config.chrome.chromedriver_path = args.chromedriver
 

linkedin_mcp_server/config/schema.py

@@ -26,10 +26,14 @@ class LinkedInConfig:
 class ServerConfig:
     """MCP server configuration."""
 
-    transport: Literal["stdio", "sse"] = "stdio"
+    transport: Literal["stdio", "streamable-http"] = "stdio"
     lazy_init: bool = True
     debug: bool = False
     setup: bool = True
+    # HTTP transport configuration
+    host: str = "127.0.0.1"
+    port: int = 8000
+    path: str = "/mcp"
 
 
 @dataclass

linkedin_mcp_server/server.py

@@ -6,7 +6,7 @@
 """
 
 from typing import Dict, Any
-from mcp.server.fastmcp import FastMCP
+from fastmcp import FastMCP
 
 from linkedin_mcp_server.drivers.chrome import active_drivers
 from linkedin_mcp_server.tools.person import register_person_tools

linkedin_mcp_server/tools/company.py

@@ -6,7 +6,7 @@
 """
 
 from typing import Dict, Any, List
-from mcp.server.fastmcp import FastMCP
+from fastmcp import FastMCP
 from linkedin_scraper import Company
 
 from linkedin_mcp_server.drivers.chrome import get_or_create_driver

linkedin_mcp_server/tools/job.py

@@ -8,7 +8,7 @@
 from typing import Any, Dict, List
 
 from linkedin_scraper import Job, JobSearch
-from mcp.server.fastmcp import FastMCP
+from fastmcp import FastMCP
 
 from linkedin_mcp_server.drivers.chrome import get_or_create_driver
 

linkedin_mcp_server/tools/person.py

@@ -6,7 +6,7 @@
 """
 
 from typing import Dict, Any, List
-from mcp.server.fastmcp import FastMCP
+from fastmcp import FastMCP
 from linkedin_scraper import Person
 
 from linkedin_mcp_server.drivers.chrome import get_or_create_driver

main.py

@@ -15,15 +15,15 @@
 from linkedin_mcp_server.server import create_mcp_server, shutdown_handler
 
 
-def choose_transport_interactive() -> Literal["stdio", "sse"]:
+def choose_transport_interactive() -> Literal["stdio", "streamable-http"]:
     """Prompt user for transport mode using inquirer."""
     questions = [
         inquirer.List(
             "transport",
             message="Choose mcp transport mode",
             choices=[
                 ("stdio (Default CLI mode)", "stdio"),
-                ("sse (Server-Sent Events HTTP mode)", "sse"),
+                ("streamable-http (HTTP server mode)", "streamable-http"),
             ],
             default="stdio",
         )
@@ -67,7 +67,18 @@ def main() -> None:
 
     # Start server
     print(f"\n🚀 Running LinkedIn MCP server ({transport.upper()} mode)...")
-    mcp.run(transport=transport)
+    if transport == "streamable-http":
+        print(
+            f"📡 HTTP server will be available at http://{config.server.host}:{config.server.port}{config.server.path}"
+        )
+        mcp.run(
+            transport=transport,
+            host=config.server.host,
+            port=config.server.port,
+            path=config.server.path,
+        )
+    else:
+        mcp.run(transport=transport)
 
 
 def exit_gracefully(exit_code: int = 0) -> None:

pyproject.toml

@@ -5,11 +5,10 @@ description = "MCP server for LinkedIn profile, company, and job scraping with C
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
-    "httpx>=0.28.1",
+    "fastmcp>=2.10.1",
     "inquirer>=3.4.0",
     "keyring>=25.6.0",
     "linkedin-scraper",
-    "mcp[cli]>=1.6.0",
     "pyperclip>=1.9.0",
 ]