oracle · HarrySnart · Dec 11, 2025 · Dec 15, 2025 · Dec 15, 2025
diff --git a/src/oci-data-science-mcp-server/.python-version b/src/oci-data-science-mcp-server/.python-version
@@ -0,0 +1 @@
+3.12
diff --git a/src/oci-data-science-mcp-server/LICENSE.txt b/src/oci-data-science-mcp-server/LICENSE.txt
@@ -0,0 +1,35 @@
+Copyright (c) 2025 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/src/oci-data-science-mcp-server/README.md b/src/oci-data-science-mcp-server/README.md
@@ -0,0 +1,71 @@
+# OCI Data Science MCP Server
+
+## Overview
+
+This server provides tools to interact with the OCI Data Science resources.
+It includes tools to help with common tasks with OCI Data Science.
+
+## Running the server
+
+```sh
+uv run oracle.oci-data-science-mcp-server
+```
+
+## Tools
+
+| Tool Name | Description |
+| --- | --- |
+| get_compartment_id | Get a list of Compartment OCID by Compartment name for use with other tools. |
+| project_count | Get count of OCI Data Science Projects |
+| create_project | Create new OCI Data Science Project with project name and description. |
+| model_count | Returns number of models saved to model catalog in OCI Data Science for a given compartment |
+| list_projects | returns a list of OCI Data Science Projects by Project Name, Project ID and Project Description as a dictionary |
+| create_notebook_session | Creates a managed Notebook Session on OCI Data Science in a given Project and Compartment. |
+| list_model_version_set_attributes | List attributes of a Model Version Set. |
+| list_model_version_sets | List all Model Version Sets in a compartment with their IDs and names. |
+| download_model_artefact | Download model artifact from the catalog. |
+| create_job_from_script | Create a job from a script. Currently only implemented to support service_conda runtimes. |
+| list_models | List models in the model catalog. |
+| list_jobs | List all jobs in a compartment with their IDs and names. |
+| job_details_by_id | List jobs information for a job based on its Job ID. |
+| list_pipelines | List all pipelines in a compartment with their IDs and names. |
+| pipelines_details_by_id | List pipeline details by Pipeline ID. |
+| start_job_run | Start a job run. |
+| start_pipeline_run | Start a pipeline run. Use list_pipelines to find the pipeline_id by name. give the run a meaningful name if possible. |
+| create_job_from_container_image | Create a job from a container image. |
+| delete_project | Delete an OCI Data Science Project. Find the Project ID by calling List Projects and finding the Project ID associated with a Project Name. |
+| activate_notebook_session | Activates a notebook session. Use list_notebook_sessions to find a notebook session id by name. |
+| delete_notebook_session | Delete a notebook session. |
+| stop_notebook_session | Stop (deactivate) a notebook session. |
+| delete_job | Delete a job. |
+| delete_pipeline | Delete a pipeline. |
+| deploy_model | Deploy a model from the catalog as a model deployment. Only works for Conda based runtimes currently. Assumes you have already saved the model to the model catalog separately |
+| activate_model_deployment | Activate an existing model deployment. |
+| deactivate_model_deployment | Deactivate (stop) a running model deployment. |
+| list_notebook_sessions | List all notebook sessions in a compartment with their IDs, names, and statuses. |
+| update_project | Update an existing project's details such as name or description. |
+| list_model_deployments | List all model deployments in a compartment with their IDs, names, and statuses. |
+| get_pipeline_run_status | Get the status and details of the most recent pipeline run for a given pipeline. This tool can be used to: - get the current status - get the started, accepted or finished date and time |
+| get_job_run_status | Get the status and details of the most recent job run for a given job. This tool can be used to: - get the current status - get the started, accepted or finished date and time |
+| list_job_runs | List all runs for a specific job, including their statuses and details. |
+| cancel_job_run | Cancel a currently running job run. |
+| list_pipeline_runs | List all runs for a specific pipeline, including statuses and details. |
+| delete_model_deployment | Delete a model deployment. |
+
+
+⚠️ **NOTE**: All actions are performed with the permissions of the configured OCI CLI profile. We advise least-privilege IAM setup, secure credential management, safe network practices, secure logging, and warn against exposing secrets.
+
+## Third-Party APIs
+
+Developers choosing to distribute a binary implementation of this project are responsible for obtaining and providing all required licenses and copyright notices for the third-party code used in order to ensure compliance with their respective open source licenses.
+
+## Disclaimer
+
+Users are responsible for their local environment and credential safety. Different language model selections may yield different results and performance.
+
+## License
+
+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/>.
diff --git a/src/oci-data-science-mcp-server/oracle/__init__.py b/src/oci-data-science-mcp-server/oracle/__init__.py
@@ -0,0 +1,5 @@
+"""
+Copyright (c) 2025, Oracle and/or its affiliates.
+Licensed under the Universal Permissive License v1.0 as shown at
+https://oss.oracle.com/licenses/upl.
+"""
diff --git a/src/oci-data-science-mcp-server/oracle/oci_data_science_mcp_server/__init__.py b/src/oci-data-science-mcp-server/oracle/oci_data_science_mcp_server/__init__.py
@@ -0,0 +1,8 @@
+"""
+Copyright (c) 2025, Oracle and/or its affiliates.
+Licensed under the Universal Permissive License v1.0 as shown at
+https://oss.oracle.com/licenses/upl.
+"""
+
+__project__ = "oracle.oci-data-science-mcp-server"
+__version__ = "0.1.0"