diff --git a/BEST_PRACTICES.md b/BEST_PRACTICES.md index 2a3fb514..1be397c9 100644 --- a/BEST_PRACTICES.md +++ b/BEST_PRACTICES.md @@ -8,6 +8,7 @@ This document lays out the best practices for an individual MCP server. You may mcp-server-name/ ├── LICENSE.txt # License information ├── pyproject.toml # Project configuration +├── CHANGELOG.md # The CHANGELOG for the server. ├── README.md # Project description, setup instructions ├── uv.lock # Dependency lockfile └── oracle/ # Source code directory @@ -209,4 +210,4 @@ def list_instances( 2. **Optional parameters**: Provide sensible defaults and mark as `Optional` in the type hint 3. **Descriptions**: Write clear, informative descriptions for each parameter 4. **Validation**: Use Field constraints like `ge`, `le`, `min_length`, `max_length` -5. **Literals**: Use `Literal` for parameters with a fixed set of valid values \ No newline at end of file +5. **Literals**: Use `Literal` for parameters with a fixed set of valid values diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b0b128e5..5be7f946 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -42,11 +42,12 @@ can be accepted. the issue number as part of your branch name, e.g. `1234-fixes`. 4. Ensure that any documentation is updated with the changes that are required by your change. -5. Ensure that any samples are updated if the base image has been changed. -6. Submit the pull request. *Do not leave the pull request blank*. Explain exactly +5. Ensure that any change to any of the MCP servers has a corresponding update in the CHANGELOG.md for that respective MCP server. Changes to MCP servers without corresponding changes in the CHANGELOG.MD will be rejected. +6. Ensure that any samples are updated if the base image has been changed. +7. Submit the pull request. *Do not leave the pull request blank*. Explain exactly what your changes are meant to do and provide simple steps on how to validate. your changes. Ensure that you reference the issue you created as well. -1. We will assign the pull request to 2-3 people for review before it is merged. +8. We will assign the pull request to 2-3 people for review before it is merged. ## Code of conduct diff --git a/src/database-mcp-server/CHANGELOG.md b/src/database-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..aecfec2d --- /dev/null +++ b/src/database-mcp-server/CHANGELOG.md @@ -0,0 +1,14 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch diff --git a/src/database-mcp-server/oracle/database_mcp_server/__init__.py b/src/database-mcp-server/oracle/database_mcp_server/__init__.py index 18a81447..7164143d 100644 --- a/src/database-mcp-server/oracle/database_mcp_server/__init__.py +++ b/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" diff --git a/src/oci-api-mcp-server/CHANGELOG.md b/src/oci-api-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..24d388d5 --- /dev/null +++ b/src/oci-api-mcp-server/CHANGELOG.md @@ -0,0 +1,38 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.3] - 2025-11-26 +- Updated the fastmcp version +- Support Autonomous Recovery Service APIs +- Fixed properly handle malformed command output +- Updated server.py to add more context for get_oci_command_help call +- Add build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.2] - 2025-11-24 +- Updated the server.py according to the new best practices doc + +## [1.0.1] - 2025-10-15 +- Fixed missing package files +- README disclaimers and consistency updates +- Package fixes and cleanup +- Fixed server output and improved prompts +- Support for a deny list of commands that should be denied execution +- Update license files and dependencies +- Add custom user agent header +- Add copyright headers +- Fixed module names for generic mcp server and improve context +- Added the OCI API MCP server diff --git a/src/oci-api-mcp-server/uv.lock b/src/oci-api-mcp-server/uv.lock index 26f8d62c..c8a11d2d 100644 --- a/src/oci-api-mcp-server/uv.lock +++ b/src/oci-api-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-api-mcp-server" -version = "1.0.2" +version = "1.0.3" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-cloud-guard-mcp-server/CHANGELOG.md b/src/oci-cloud-guard-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..eba2cb26 --- /dev/null +++ b/src/oci-cloud-guard-mcp-server/CHANGELOG.md @@ -0,0 +1,18 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.1] - 2025-11-26 +- Updated the fastmcp version diff --git a/src/oci-cloud-guard-mcp-server/uv.lock b/src/oci-cloud-guard-mcp-server/uv.lock index 50e5e3c7..a2e791e4 100644 --- a/src/oci-cloud-guard-mcp-server/uv.lock +++ b/src/oci-cloud-guard-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-cloud-guard-mcp-server" -version = "1.0.0" +version = "1.0.1" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-compute-instance-agent-mcp-server/CHANGELOG.md b/src/oci-compute-instance-agent-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..0f9d3d98 --- /dev/null +++ b/src/oci-compute-instance-agent-mcp-server/CHANGELOG.md @@ -0,0 +1,30 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [2.0.1] - 2025-11-26 +- Updated the fastmcp version +- Improved the OCI MCP server consistency +- Added build, versioning, and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Update license files and dependencies +- Add custom user agent header +- Add copyright headers +- Added the OCI Compute instance agent MCP server + diff --git a/src/oci-compute-instance-agent-mcp-server/uv.lock b/src/oci-compute-instance-agent-mcp-server/uv.lock index 1819dacd..654b2868 100644 --- a/src/oci-compute-instance-agent-mcp-server/uv.lock +++ b/src/oci-compute-instance-agent-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-compute-instance-agent-mcp-server" -version = "2.0.0" +version = "2.0.1" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-compute-mcp-server/CHANGELOG.md b/src/oci-compute-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..2739a84f --- /dev/null +++ b/src/oci-compute-mcp-server/CHANGELOG.md @@ -0,0 +1,35 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.1.0] - 2025-11-26 +- Improved consistency +- Updated the fastmcp version +- Added build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.2] - 2025-10-30 +- Updated the code to conform to the new best practices document + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- List instances limit and lifecycle state filter +- Fix update instance +- Implement launch instance +- Add copyright headers +- Remove utils from compute server +- Strong types in the compute server +- Added the OCI Compute MCP server + diff --git a/src/oci-compute-mcp-server/uv.lock b/src/oci-compute-mcp-server/uv.lock index faba35f1..71e5215e 100644 --- a/src/oci-compute-mcp-server/uv.lock +++ b/src/oci-compute-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-compute-mcp-server" -version = "1.0.2" +version = "1.1.0" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-identity-mcp-server/CHANGELOG.md b/src/oci-identity-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..c601a957 --- /dev/null +++ b/src/oci-identity-mcp-server/CHANGELOG.md @@ -0,0 +1,26 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Update license files +- Update dependencies +- Added custom user agent header +- Added copyright headers diff --git a/src/oci-identity-mcp-server/uv.lock b/src/oci-identity-mcp-server/uv.lock index 1011c897..86bf5203 100644 --- a/src/oci-identity-mcp-server/uv.lock +++ b/src/oci-identity-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-identity-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-logging-mcp-server/CHANGELOG.md b/src/oci-logging-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..0b0aed1a --- /dev/null +++ b/src/oci-logging-mcp-server/CHANGELOG.md @@ -0,0 +1,28 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.1.1] - 2025-11-26 +- Updated the fastmcp version +- Fixes the logging server output and added a new search tool +- Added build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- Added missing package files +- README disclaimers and consistency updates +- Logging MCP Server + + diff --git a/src/oci-logging-mcp-server/uv.lock b/src/oci-logging-mcp-server/uv.lock index 4576c614..00229800 100644 --- a/src/oci-logging-mcp-server/uv.lock +++ b/src/oci-logging-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-logging-mcp-server" -version = "1.1.0" +version = "1.1.1" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-migration-mcp-server/CHANGELOG.md b/src/oci-migration-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..fd6e7b3a --- /dev/null +++ b/src/oci-migration-mcp-server/CHANGELOG.md @@ -0,0 +1,29 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version +- Added build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Updated license files +- Update dependencies +- Added custom user agent header +- Added copyright headers + diff --git a/src/oci-migration-mcp-server/uv.lock b/src/oci-migration-mcp-server/uv.lock index a10bbc33..34dedfc0 100644 --- a/src/oci-migration-mcp-server/uv.lock +++ b/src/oci-migration-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-migration-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-monitoring-mcp-server/CHANGELOG.md b/src/oci-monitoring-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..f92ba731 --- /dev/null +++ b/src/oci-monitoring-mcp-server/CHANGELOG.md @@ -0,0 +1,29 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version +- Added build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup + +## [1.0.0] - 2025-10-13 +- Usage MCP server for cost analysis +- Update license files and dependencies +- Added copyright headers diff --git a/src/oci-monitoring-mcp-server/uv.lock b/src/oci-monitoring-mcp-server/uv.lock index b5b4c82c..070fab96 100644 --- a/src/oci-monitoring-mcp-server/uv.lock +++ b/src/oci-monitoring-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-monitoring-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-network-load-balancer-mcp-server/CHANGELOG.md b/src/oci-network-load-balancer-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..6e8207b8 --- /dev/null +++ b/src/oci-network-load-balancer-mcp-server/CHANGELOG.md @@ -0,0 +1,32 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version +- Add build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Update license files and dependencies +- Add custom user agent header +- Add copyright headers +- Lock down subprocess a bit more and fix tests +- Add network security tools +- Add NLB tests +- Implement basic NLB server + + diff --git a/src/oci-network-load-balancer-mcp-server/uv.lock b/src/oci-network-load-balancer-mcp-server/uv.lock index ebca0d79..9f61e036 100644 --- a/src/oci-network-load-balancer-mcp-server/uv.lock +++ b/src/oci-network-load-balancer-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-network-load-balancer-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-networking-mcp-server/CHANGELOG.md b/src/oci-networking-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..cab7fc54 --- /dev/null +++ b/src/oci-networking-mcp-server/CHANGELOG.md @@ -0,0 +1,29 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.1.0] - 2025-11-26 +- Updated the fastmcp version +- Added build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Update license files and dependencies +- Finish unit tests for networking mcp server +- Add custom user agent header +- Add network security tools and unit tests + diff --git a/src/oci-networking-mcp-server/uv.lock b/src/oci-networking-mcp-server/uv.lock index c04c85f5..7ae1bc70 100644 --- a/src/oci-networking-mcp-server/uv.lock +++ b/src/oci-networking-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-networking-mcp-server" -version = "1.0.1" +version = "1.1.0" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-object-storage-mcp-server/CHANGELOG.md b/src/oci-object-storage-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..6189d7c1 --- /dev/null +++ b/src/oci-object-storage-mcp-server/CHANGELOG.md @@ -0,0 +1,27 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version +- Add build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Added OCI Object Storage Service MCP Server + + diff --git a/src/oci-object-storage-mcp-server/uv.lock b/src/oci-object-storage-mcp-server/uv.lock index 1fa76632..f2600c83 100644 --- a/src/oci-object-storage-mcp-server/uv.lock +++ b/src/oci-object-storage-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-object-storage-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-registry-mcp-server/CHANGELOG.md b/src/oci-registry-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..0251f1f0 --- /dev/null +++ b/src/oci-registry-mcp-server/CHANGELOG.md @@ -0,0 +1,28 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version +- Add build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Update license files and dependencies +- Add custom user agent header +- add copyright headers +- Added the OCI Registry MCP Server diff --git a/src/oci-registry-mcp-server/uv.lock b/src/oci-registry-mcp-server/uv.lock index ad416627..1c8b4a9b 100644 --- a/src/oci-registry-mcp-server/uv.lock +++ b/src/oci-registry-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-registry-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-resource-search-mcp-server/CHANGELOG.md b/src/oci-resource-search-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..1c39eb3b --- /dev/null +++ b/src/oci-resource-search-mcp-server/CHANGELOG.md @@ -0,0 +1,28 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version +- Add build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Update license files and dependencies +- Add custom user agent header +- Add tests +- Add the OCI Resource Search MCP server diff --git a/src/oci-resource-search-mcp-server/uv.lock b/src/oci-resource-search-mcp-server/uv.lock index fbd9953b..d0df6567 100644 --- a/src/oci-resource-search-mcp-server/uv.lock +++ b/src/oci-resource-search-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-resource-search-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/src/oci-usage-mcp-server/CHANGELOG.md b/src/oci-usage-mcp-server/CHANGELOG.md new file mode 100644 index 00000000..089dce0e --- /dev/null +++ b/src/oci-usage-mcp-server/CHANGELOG.md @@ -0,0 +1,28 @@ +# Changelog + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +The sub-sections are used to generate the next version of the project. + +## [Unreleased] + +### Major (breaking) + +### Minor (non-breaking) + +### Patch + + +## [1.0.2] - 2025-11-26 +- Updated the fastmcp version +- Add build, versioning and publishing infrastructure +- Added support for coverage report generation + +## [1.0.1] - 2025-10-15 +- README disclaimers and consistency updates +- Package fixes and cleanup +- Added the Usage MCP server for cost analysis + + + diff --git a/src/oci-usage-mcp-server/uv.lock b/src/oci-usage-mcp-server/uv.lock index d2a0013f..c6001a1b 100644 --- a/src/oci-usage-mcp-server/uv.lock +++ b/src/oci-usage-mcp-server/uv.lock @@ -735,7 +735,7 @@ wheels = [ [[package]] name = "oracle-oci-usage-mcp-server" -version = "1.0.1" +version = "1.0.2" source = { editable = "." } dependencies = [ { name = "fastmcp" },