use env vars instead

Signed-off-by: Richard Gebhardt <[email protected]>

Author: gebhardtr

README.md

@@ -55,6 +55,26 @@ For macOS/Linux:
 }
 ```
 
+To connect to an MCP server running in HTTP steaming mode:
+Assuming you started the server by running:
+```bash
+MCP_HOST=localhost MCP_PORT=8888 uvx oracle.oci-api-mcp-server
+```
+then place the following in your MCP client configuration:
+:warning: NOTE: the `type` attribute may be client-specific. Some MCP clients
+use `http` as the transport value while others (like Cline) will expect `streamableHttp`.
+
+```json
+{
+  "mcpServers": {
+    "oracle-oci-api-mcp-server": {
+      "type": "streamableHttp",
+      "url": "http://localhost:8888/mcp"
+    }
+  }
+}
+```
+
 ## Authentication
 
 For OCI MCP servers, you'll need to install and authenticate using the OCI CLI.
@@ -309,6 +329,17 @@ update it as needed. For instance:
 where `<absolute path to your server code>` is the absolute path to the server code, for instance
 `/Users/myuser/dev/oci-mcp/src/oci-identity-mcp-server/oracle/oci_identity_mcp_server`.
 
+To build and test servers running in HTTP transport mode:
+```bash
+make build
+make install
+```
+
+then start the server:
+```bash
+VIRTUAL_ENV=$(pwd)/.venv MCP_HOST=0.0.0.0 MCP_PORT=8888 uv run oracle.oci-api-mcp-server
+```
+
 ### Inspector
 
 The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction)

src/database-mcp-server/oracle/database_mcp_server/__init__.py

@@ -5,4 +5,4 @@
 """
 
 __project__ = "oracle.database-mcp-server"
-__version__ = "1.0.0"
+__version__ = "1.0.1"

src/oci-api-mcp-server/README.md

@@ -7,9 +7,18 @@ It includes tools to help with OCI command execution and provide helpful informa
 
 ## Running the server
 
+### STDIO transport mode
+
+```sh
+uvx oracle.oci-api-mcp-server
+```
+
+### HTTP streaming transport mode
+
 ```sh
-uv run oracle.oci-api-mcp-server
+MCP_HOST=<hostname/IP address> MCP_PORT=<port number> uvx oracle.oci-api-mcp-server
 ```
+
 ## Tools
 
 | Tool Name | Description |

src/oci-api-mcp-server/oracle/oci_api_mcp_server/__init__.py

@@ -5,4 +5,4 @@
 """
 
 __project__ = "oracle.oci-api-mcp-server"
-__version__ = "1.0.3"
+__version__ = "1.1.0"

src/oci-api-mcp-server/oracle/oci_api_mcp_server/server.py

@@ -4,7 +4,6 @@
 https://oss.oracle.com/licenses/upl.
 """
 
-import argparse
 import json
 import os
 import subprocess
@@ -209,13 +208,11 @@ def run_oci_command(
 
 def main():
 
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--port", type=int, help="Port to use for HTTP mode")
-    parser.add_argument("--host", type=str, help="Hostname or IP address to bind to")
-    args = parser.parse_args()
+    host = os.getenv("MCP_HOST")
+    port = os.getenv("MCP_PORT")
 
-    if args.port and args.host:
-        mcp.run(transport="http", host=args.host, port=args.port)
+    if host and port:
+        mcp.run(transport="http", host=host, port=int(port))
     else:
         mcp.run()
 

src/oci-api-mcp-server/oracle/oci_api_mcp_server/tests/test_oci_api_tools.py

@@ -205,6 +205,56 @@ async def test_run_oci_command_denied(self, mock_json_loads, mock_run):
                 )
             ).data
 
-            print(type(result))
             assert "error" in result
             assert any("denied by denylist" in value for value in result.values())
+
+
+class TestServer:
+    @patch("oracle.oci_api_mcp_server.server.mcp.run")
+    @patch("os.getenv")
+    def test_main_with_host_and_port(self, mock_getenv, mock_mcp_run):
+        mock_env = {
+            "MCP_HOST": "1.2.3.4",
+            "MCP_PORT": 8888,
+        }
+
+        mock_getenv.side_effect = lambda x: mock_env.get(x)
+        import oracle.oci_api_mcp_server.server as server
+
+        server.main()
+        mock_mcp_run.assert_called_once_with(
+            transport="http", host=mock_env["MCP_HOST"], port=mock_env["MCP_PORT"]
+        )
+
+    @patch("oracle.oci_api_mcp_server.server.mcp.run")
+    @patch("os.getenv")
+    def test_main_without_host_and_port(self, mock_getenv, mock_mcp_run):
+        mock_getenv.return_value = None
+        import oracle.oci_api_mcp_server.server as server
+
+        server.main()
+        mock_mcp_run.assert_called_once_with()
+
+    @patch("oracle.oci_api_mcp_server.server.mcp.run")
+    @patch("os.getenv")
+    def test_main_with_only_host(self, mock_getenv, mock_mcp_run):
+        mock_env = {
+            "MCP_HOST": "1.2.3.4",
+        }
+        mock_getenv.side_effect = lambda x: mock_env.get(x)
+        import oracle.oci_api_mcp_server.server as server
+
+        server.main()
+        mock_mcp_run.assert_called_once_with()
+
+    @patch("oracle.oci_api_mcp_server.server.mcp.run")
+    @patch("os.getenv")
+    def test_main_with_only_port(self, mock_getenv, mock_mcp_run):
+        mock_env = {
+            "MCP_PORT": "8888",
+        }
+        mock_getenv.side_effect = lambda x: mock_env.get(x)
+        import oracle.oci_api_mcp_server.server as server
+
+        server.main()
+        mock_mcp_run.assert_called_once_with()

src/oci-api-mcp-server/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oracle.oci-api-mcp-server"
-version = "1.0.3"
+version = "1.1.0"
 description = "OCI CLI MCP server"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -49,5 +49,3 @@ omit = [
 [tool.coverage.report]
 precision = 2
 fail_under = 91.81
-
-

src/oci-api-mcp-server/uv.lock

@@ -7,8 +7,16 @@ It includes tools to help with managing cloud guard problems.
 
 ## Running the server
 
+### STDIO transport mode
+
 ```sh
-uv run oracle.oci-cloud-guard-mcp-server
+uvx oracle.oci-cloud-guard-mcp-server
+```
+
+### HTTP streaming transport mode
+
+```sh
+MCP_HOST=<hostname/IP address> MCP_PORT=<port number> uvx oracle.oci-cloud-guard-mcp-server
 ```
 
 ## Tools
@@ -35,5 +43,3 @@ Copyright (c) 2025 Oracle and/or its affiliates.
 
 Released under the Universal Permissive License v1.0 as shown at  
 <https://oss.oracle.com/licenses/upl/>.
-
-

src/oci-cloud-guard-mcp-server/README.md

@@ -5,4 +5,4 @@
 """
 
 __project__ = "oracle.oci-cloud-guard-mcp-server"
-__version__ = "1.0.1"
+__version__ = "1.1.0"