Skip to content

Add MCP Server Template #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
cboffa13 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add MCP Server Template #10

cboffa13 wants to merge 1 commit into from

Conversation

@cboffa13
Copy link

@cboffa13 cboffa13 commented Jan 6, 2026 •
edited
Loading

Description

This PR adds the MCP server template generator using cookiecutter. This allows service teams to quick generate project structure following the guidelines of the official OCI MCP Repo

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

This has been tested within this repo and used with the official OCI MCP Repo

Usage

  1. Run the below command in the root of the OCI MCP Repo

    uvx cookiecutter https://github.com/cboffa13/mcp-examples.git --checkout cboffa/feature/mcp-generator --output-dir ./src --directory generator

  2. Follow the prompts to enter the required information

  3. Cookiecutter will generate a new directory with your MCP server project.

  4. Run make build && make install

  5. Once that folder is generated, add the new server to cline and try it out

Details Screenshot 2026-01-06 at 3 28 20 PM
  1. Run some test query and it should work out-of-the-box
Details Screenshot 2026-01-06 at 3 29 21 PM

Testing

  1. If you want to test the project template, run the below command 
    uvx cookiecutter generator
  2. Following the prompts and it will generator a directory with your MCP servers.
  3. Adjust the files within the generator folder to modify the output
Screenshot 2026-01-06 at 3 20 16 PM

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published in downstream modules

@oracle-contributor-agreement oracle-contributor-agreement bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Jan 6, 2026
@cboffa13 cboffa13 changed the title feat(generator): add mcp cookie cutter template Add MCP Server Template Jan 6, 2026
@cboffa13 cboffa13 force-pushed the cboffa/feature/mcp-generator branch from 4f9b33b to 4599dfa Compare January 8, 2026 16:41
shopewf
shopewf reviewed Jan 12, 2026
View reviewed changes
...r.project_domain | lower | replace(' ', '-') | replace('_', '-')}}-mcp-server/pyproject.toml
".venv/*",
]

[tool.coverage.report]
Copy link

@shopewf shopewf Jan 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add the omit item here

[tool.coverage.report]
omit = [
    "**/__init__.py",
    "**/tests/*",
]
precision = 2
fail_under = 90

Copy link
Author

@cboffa13 cboffa13 Jan 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added

shopewf
shopewf reviewed Jan 12, 2026
View reviewed changes
...ject_domain | lower | replace(' ', '-') | replace('_', '-')}}-mcp-server/uv-requirements.txt Outdated
Copy link

@shopewf shopewf Jan 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need this file? I dont see it in our other servers

Copy link
Author

@cboffa13 cboffa13 Jan 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

removed

@cboffa13 cboffa13 force-pushed the cboffa/feature/mcp-generator branch from 4599dfa to 3101cb9 Compare January 14, 2026 16:15
@banderson-oracle
Copy link
Member

banderson-oracle commented Jan 21, 2026 •
edited
Loading

Needs to generate Containerfile for podman, as well as .containerignore

banderson-oracle
banderson-oracle reviewed Jan 21, 2026
View reviewed changes
...cutter.project_domain | lower | replace(' ', '_') | replace('-', '_')}}_mcp_server/server.py
@@ -0,0 +1,56 @@
"""
Copyright (c) 2025, Oracle and/or its affiliates.
Copy link
Member

@banderson-oracle banderson-oracle Jan 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make this dynamic based on the actual year.

banderson-oracle
banderson-oracle reviewed Jan 21, 2026
View reviewed changes
...est_{{cookiecutter.project_domain | lower | replace(' ', '_') | replace('-', '_')}}_tools.py
@@ -0,0 +1,30 @@
"""
Copyright (c) 2025, Oracle and/or its affiliates.
Copy link
Member

@banderson-oracle banderson-oracle Jan 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make this dynamic based on the actual year.

banderson-oracle
banderson-oracle reviewed Jan 21, 2026
View reviewed changes
...oject_domain | lower | replace(' ', '-') | replace('_', '-')}}-mcp-server/oracle/__init__.py
@@ -0,0 +1,5 @@
"""
Copyright (c) 2025, Oracle and/or its affiliates.
Copy link
Member

@banderson-oracle banderson-oracle Jan 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make this dynamic based on the actual year.

banderson-oracle
banderson-oracle reviewed Jan 21, 2026
View reviewed changes
...tter.project_domain | lower | replace(' ', '-') | replace('_', '-')}}-mcp-server/LICENSE.txt
@@ -0,0 +1,35 @@
Copyright (c) 2025 Oracle and/or its affiliates.
Copy link
Member

@banderson-oracle banderson-oracle Jan 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make this dynamic based on the actual year.

gebhardtr
gebhardtr reviewed Jan 23, 2026
View reviewed changes
...utter.project_domain | lower | replace(' ', '-') | replace('_', '-')}}-mcp-server/.gitignore
ENV/

# IDE
.idea/
Copy link
Member

@gebhardtr gebhardtr Jan 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

would it be better to manage user-specific config/dotfiles in the user's global gitignore?

gebhardtr
gebhardtr reviewed Jan 23, 2026
View reviewed changes
.gitignore
**/.venv
**/.langgraph_api/

.idea
Copy link
Member

@gebhardtr gebhardtr Jan 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

would it be better to manage user-specific config/dotfiles in the user's global gitignore?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@gebhardtr gebhardtr gebhardtr left review comments

+3 more reviewers

@banderson-oracle banderson-oracle banderson-oracle left review comments

@shopewf shopewf shopewf approved these changes

@dharshashank dharshashank dharshashank approved these changes

Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@cboffa13 @banderson-oracle @gebhardtr @shopewf @dharshashank