change port

Author: Nisha Saini

Containerfile

@@ -10,5 +10,8 @@ RUN pip install --no-cache-dir -r requirements.txt
 # Copy source code (uses .containerignore)
 COPY . .
 
+# Expose port for HTTP transport (only used when MCP_TRANSPORT=http)
+EXPOSE 8085
+
 # Entrypoint
 CMD ["python", "gitlab_mcp_server.py"] 

Makefile

@@ -13,13 +13,17 @@ build:
 	podman build -t $(IMG) .
 
 # Notes:
-# - $(ENV_FILE) is expected to define _URL & JIRA_API_TOKEN.
+# - $(ENV_FILE) is expected to define the gitlab token & repos other vars are optional..
 # - The --tty option is used here since we might run this in a
 #   terminal, but for the mcp.json version we don't use --tty.
 # - You can use Ctrl-D to quit nicely.
 run:
 	@podman run -i --tty --rm --env-file $(ENV_FILE) $(IMG)
 
+run-http:
+	@echo "🌐 Starting GitLab MCP server in HTTP mode"
+	@podman run -i --rm --env-file $(ENV_FILE) -p 8085:8085 -e MCP_TRANSPORT=http $(IMG)
+
 clean:
 	podman rmi -i $(IMG)
 
@@ -35,6 +39,6 @@ cursor-config:
 # Copy the example .env file only if it doesn't exist already
 $(ENV_FILE):
 	@cp example.env $@
-	@echo "🛠️ Env file created. Edit $@ to add your Jira token"
+	@echo "🛠️ Env file created. Edit $@ to add your GitLab token"
 
 setup: build cursor-config $(ENV_FILE)

README.md

@@ -115,8 +115,8 @@ The MCP follows:
 ```
 
 ### list_pipelines
-```json
-{
+   ```json
+   {
   "project_id": "123",            // Required: GitLab project ID
   "status": "all",                // running, pending, success, failed, all
   "limit": 20                     // max results

example-http.mcp.json

@@ -0,0 +1,24 @@
+{
+  "mcpServers": {
+    "gitlabMCP_HTTP": {
+      "command": "podman",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "--env-file",
+        "~/.rh-gitlab-mcp.env",
+        "-p",
+        "8085:8085",
+        "-e",
+        "MCP_TRANSPORT=http",
+        "localhost/gitlab-mcp:latest"
+      ],
+      "description": "A containerized GitLab MCP server using HTTP transport",
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:8085"
+      }
+    }
+  }
+}

example.env

@@ -17,6 +17,13 @@ GITLAB_URL=https://gitlab.com
 # Optional: Transport mode (stdio or http)
 MCP_TRANSPORT=stdio
 
+# HTTP Transport Configuration (only used when MCP_TRANSPORT=http)
+MCP_HOST=127.0.0.1
+MCP_PORT=8085
+
+# Recommended ports for multiple MCP servers:
+# GitLab MCP: 8086, Jira MCP: 8087, Other MCP: 8088, 8089, etc.
+
 # Optional: API rate limiting
 MCP_MAX_API_CALLS=100
 

example.mcp.json

@@ -1,6 +1,6 @@
 {
   "mcpServers": {
-    "jiraMcp": {
+    "gitlabMCP": {
       "command": "podman",
       "args": [
         "run",

gitlab_mcp_server.py

@@ -57,7 +57,7 @@ def __init__(self):
 
         # SSL Configuration options
         ssl_verify = os.getenv("MCP_SSL_VERIFY", "true").lower() == "true"
-        ssl_ca_bundle = os.getenv("MCP_SSL_CA_BUNDLE")  # Path to CA bundle file
+        ssl_ca_bundle = os.getenv("SSL_CERT_FILE")  # Path to CA bundle file
 
         # Build GitLab client configuration
         gitlab_config = {
@@ -808,6 +808,9 @@ async def list_latest_commits(request: CommitsRequest) -> dict:
 
 def main():
     """Main entry point for the FastMCP server."""
+    # Get transport mode from environment
+    transport_mode = os.getenv("MCP_TRANSPORT", "stdio").lower()
+    
     print("🚀 Starting GitLab MCP Server (FastMCP - Read-Only)...")
     print("📋 Available Tools:")
     print("   🔍 search_repositories - Search/filter repositories")
@@ -821,10 +824,24 @@ def main():
     print(f"🔒 Actions: {config.allowed_actions}")
     print(f"🔗 GitLab: {config.gitlab_url}")
     print("📖 Query Support: Both project_id and project_name supported for flexible access")
-    print("\n✅ FastMCP Read-Only Server ready for connections!")
-
-    # Run the FastMCP server
-    mcp.run()
+    print(f"🚀 Transport Mode: {transport_mode.upper()}")
+    
+    if transport_mode == "http":
+        # HTTP Transport configuration
+        host = os.getenv("MCP_HOST", "127.0.0.1")
+        port = int(os.getenv("MCP_PORT", "8085"))
+        
+        print(f"🌐 Starting HTTP server on {host}:{port}")
+        print("\n✅ FastMCP HTTP Server ready for connections!")
+        
+        # Run with HTTP transport
+        mcp.run(transport="http", host=host, port=port)
+    else:
+        # Default STDIO transport
+        print("\n✅ FastMCP STDIO Server ready for connections!")
+        
+        # Run with STDIO transport (default)
+        mcp.run()
 
 if __name__ == "__main__":
     main() 

multi-mcp-example.json

@@ -0,0 +1,43 @@
+{
+  "mcpServers": {
+    "gitlabMcp": {
+      "command": "podman",
+      "args": [
+        "run", "-i", "--rm", "--env-file", "~/.rh-gitlab-mcp.env",
+        "-p", "8086:8086", "-e", "MCP_TRANSPORT=http",
+        "localhost/gitlab-mcp:latest"
+      ],
+      "description": "GitLab MCP server on port 8086",
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:8086"
+      }
+    },
+    "jiraMcp": {
+      "command": "podman",
+      "args": [
+        "run", "-i", "--rm", "--env-file", "~/.rh-jira-mcp.env",
+        "-p", "8087:8087", "-e", "MCP_TRANSPORT=http", "-e", "MCP_PORT=8087",
+        "localhost/jira-mcp:latest"
+      ],
+      "description": "Jira MCP server on port 8087",
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:8087"
+      }
+    },
+    "otherMcp": {
+      "command": "podman",
+      "args": [
+        "run", "-i", "--rm", "--env-file", "~/.other-mcp.env",
+        "-p", "8088:8088", "-e", "MCP_TRANSPORT=http", "-e", "MCP_PORT=8088",
+        "localhost/other-mcp:latest"
+      ],
+      "description": "Other MCP server on port 8088",
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:8088"
+      }
+    }
+  }
+}

requirements.txt

@@ -1,3 +1,3 @@
 fastmcp==2.11.2
-gitlab==1.0.2
+python-gitlab==4.0.0
 pydantic==2.11.7