Skip to content

Commit ae79a42

Browse files
committed
chore: Add changelogs to support publishing of MCP servers
- Added changelogs for all OCI MCP servers with information on already released versions. - Updated the version in uv.lock files to match the version in pyproject.toml
1 parent 8dc08a9 commit ae79a42

File tree

32 files changed

+440
-19
lines changed

32 files changed

+440
-19
lines changed

BEST_PRACTICES.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ This document lays out the best practices for an individual MCP server. You may
88
mcp-server-name/
99
├── LICENSE.txt # License information
1010
├── pyproject.toml # Project configuration
11+
├── CHANGELOG.md # The CHANGELOG for the server.
1112
├── README.md # Project description, setup instructions
1213
├── uv.lock # Dependency lockfile
1314
└── oracle/ # Source code directory
@@ -209,4 +210,4 @@ def list_instances(
209210
2. **Optional parameters**: Provide sensible defaults and mark as `Optional` in the type hint
210211
3. **Descriptions**: Write clear, informative descriptions for each parameter
211212
4. **Validation**: Use Field constraints like `ge`, `le`, `min_length`, `max_length`
212-
5. **Literals**: Use `Literal` for parameters with a fixed set of valid values
213+
5. **Literals**: Use `Literal` for parameters with a fixed set of valid values

CONTRIBUTING.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,11 +42,12 @@ can be accepted.
4242
the issue number as part of your branch name, e.g. `1234-fixes`.
4343
4. Ensure that any documentation is updated with the changes that are required
4444
by your change.
45-
5. Ensure that any samples are updated if the base image has been changed.
46-
6. Submit the pull request. *Do not leave the pull request blank*. Explain exactly
45+
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.
46+
6. Ensure that any samples are updated if the base image has been changed.
47+
7. Submit the pull request. *Do not leave the pull request blank*. Explain exactly
4748
what your changes are meant to do and provide simple steps on how to validate.
4849
your changes. Ensure that you reference the issue you created as well.
49-
1. We will assign the pull request to 2-3 people for review before it is merged.
50+
8. We will assign the pull request to 2-3 people for review before it is merged.
5051

5152
## Code of conduct
5253

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Changelog
2+
3+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
4+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
5+
6+
The sub-sections are used to generate the next version of the project.
7+
8+
## [Unreleased]
9+
10+
### Major (breaking)
11+
12+
### Minor (non-breaking)
13+
14+
### Patch

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@
55
"""
66

77
__project__ = "oracle.database-mcp-server"
8-
__version__ = "1.0.0"
8+
__version__ = "1.0.1"
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Changelog
2+
3+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
4+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
5+
6+
The sub-sections are used to generate the next version of the project.
7+
8+
## [Unreleased]
9+
10+
### Major (breaking)
11+
12+
### Minor (non-breaking)
13+
14+
### Patch
15+
16+
17+
## [1.0.3] - 2025-11-26
18+
- Updated the fastmcp version
19+
- Support Autonomous Recovery Service APIs
20+
- Fixed properly handle malformed command output
21+
- Updated server.py to add more context for get_oci_command_help call
22+
- Add build, versioning and publishing infrastructure
23+
- Added support for coverage report generation
24+
25+
## [1.0.2] - 2025-11-24
26+
- Updated the server.py according to the new best practices doc
27+
28+
## [1.0.1] - 2025-10-15
29+
- Fixed missing package files
30+
- README disclaimers and consistency updates
31+
- Package fixes and cleanup
32+
- Fixed server output and improved prompts
33+
- Support for a deny list of commands that should be denied execution
34+
- Update license files and dependencies
35+
- Add custom user agent header
36+
- Add copyright headers
37+
- Fixed module names for generic mcp server and improve context
38+
- Added the OCI API MCP server

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

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Changelog
2+
3+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
4+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
5+
6+
The sub-sections are used to generate the next version of the project.
7+
8+
## [Unreleased]
9+
10+
### Major (breaking)
11+
12+
### Minor (non-breaking)
13+
14+
### Patch
15+
16+
17+
## [1.0.1] - 2025-11-26
18+
- Updated the fastmcp version

src/oci-cloud-guard-mcp-server/uv.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Changelog
2+
3+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
4+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
5+
6+
The sub-sections are used to generate the next version of the project.
7+
8+
## [Unreleased]
9+
10+
### Major (breaking)
11+
12+
### Minor (non-breaking)
13+
14+
### Patch
15+
16+
17+
## [2.0.1] - 2025-11-26
18+
- Updated the fastmcp version
19+
- Improved the OCI MCP server consistency
20+
- Added build, versioning, and publishing infrastructure
21+
- Added support for coverage report generation
22+
23+
## [1.0.1] - 2025-10-15
24+
- README disclaimers and consistency updates
25+
- Package fixes and cleanup
26+
- Update license files and dependencies
27+
- Add custom user agent header
28+
- Add copyright headers
29+
- Added the OCI Compute instance agent MCP server
30+

src/oci-compute-instance-agent-mcp-server/uv.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)