From fcc8f2c8af920b0ee6df51241ae60865d4e7dc26 Mon Sep 17 00:00:00 2001 From: OtherVibes Date: Wed, 24 Sep 2025 23:59:51 +0300 Subject: [PATCH 1/3] docs/add-community-resources-section - add community resources section with OtherVibes/mcp-publish-action Add Community Resources section to GitHub Actions guide referencing OtherVibes/mcp-publish-action as requested in discussion #518. - Add third-party GitHub Action reference with appropriate disclaimers - Include example usage and key features - Position after Tips section for discoverability - Structure allows for future community tool additions Addresses: #518 --- docs/guides/publishing/github-actions.md | 34 ++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/docs/guides/publishing/github-actions.md b/docs/guides/publishing/github-actions.md index a320136bb..3501f2547 100644 --- a/docs/guides/publishing/github-actions.md +++ b/docs/guides/publishing/github-actions.md @@ -136,6 +136,40 @@ You can keep your package version and server.json version in sync automatically jq --arg v "$VERSION" '.version = $v' server.json > tmp && mv tmp server.json ``` +## Community Resources + +**⚠️ Disclaimer**: The following are third-party, community-maintained tools that are not officially endorsed by the MCP Registry team. Use at your own discretion and review the source code before using in production. + +### Third-party GitHub Actions + +#### OtherVibes/mcp-publish-action + +A reusable GitHub Action that simplifies automated MCP server publishing by handling `server.json` creation and using the MCP Publisher CLI with GitHub OIDC authentication. + +**Repository**: [OtherVibes/mcp-publish-action](https://github.com/OtherVibes/mcp-publish-action) + +**Key Features**: +- Automatically constructs `server.json` using the official schema +- Supports multiple registry types (PyPI, npm, OCI, NuGet, MCPB) +- Supports multiple transport types (stdio, streamable-http, sse) +- Uses GitHub OIDC authentication (no secrets required) +- Reduces workflow boilerplate + +**Example Usage**: +```yaml +- name: Publish to MCP Registry + uses: OtherVibes/mcp-publish-action@v1 + with: + name: io.github.owner/repo + description: "MCP server providing weather data and forecasts" + version: "1.0.0" + registry_type: pypi + identifier: my-server + transport_type: stdio +``` + +**Benefits**: Zero need to copy workflow YAML steps, keeps up with protocol changes, and aligns with OIDC best practices. + ## Troubleshooting - **"Authentication failed"**: Ensure `id-token: write` permission is set for OIDC, or check secrets - **"Package validation failed"**: Verify your package published to your registry (NPM, PyPi etc.) successfully first, and that you have done the necessary validation steps in the [Publishing Tutorial](publish-server.md) \ No newline at end of file From de75ec8a93f32d4635607911625cda35afef0d68 Mon Sep 17 00:00:00 2001 From: Radoslav Dimitrov Date: Mon, 29 Sep 2025 23:43:18 +0300 Subject: [PATCH 2/3] Revert "docs/add-community-resources-section - add community resources section with OtherVibes/mcp-publish-action" This reverts commit f36a15574cf9921f2012f019b1e6d047a5972ffb. --- docs/guides/publishing/github-actions.md | 34 ------------------------ 1 file changed, 34 deletions(-) diff --git a/docs/guides/publishing/github-actions.md b/docs/guides/publishing/github-actions.md index 3501f2547..a320136bb 100644 --- a/docs/guides/publishing/github-actions.md +++ b/docs/guides/publishing/github-actions.md @@ -136,40 +136,6 @@ You can keep your package version and server.json version in sync automatically jq --arg v "$VERSION" '.version = $v' server.json > tmp && mv tmp server.json ``` -## Community Resources - -**⚠️ Disclaimer**: The following are third-party, community-maintained tools that are not officially endorsed by the MCP Registry team. Use at your own discretion and review the source code before using in production. - -### Third-party GitHub Actions - -#### OtherVibes/mcp-publish-action - -A reusable GitHub Action that simplifies automated MCP server publishing by handling `server.json` creation and using the MCP Publisher CLI with GitHub OIDC authentication. - -**Repository**: [OtherVibes/mcp-publish-action](https://github.com/OtherVibes/mcp-publish-action) - -**Key Features**: -- Automatically constructs `server.json` using the official schema -- Supports multiple registry types (PyPI, npm, OCI, NuGet, MCPB) -- Supports multiple transport types (stdio, streamable-http, sse) -- Uses GitHub OIDC authentication (no secrets required) -- Reduces workflow boilerplate - -**Example Usage**: -```yaml -- name: Publish to MCP Registry - uses: OtherVibes/mcp-publish-action@v1 - with: - name: io.github.owner/repo - description: "MCP server providing weather data and forecasts" - version: "1.0.0" - registry_type: pypi - identifier: my-server - transport_type: stdio -``` - -**Benefits**: Zero need to copy workflow YAML steps, keeps up with protocol changes, and aligns with OIDC best practices. - ## Troubleshooting - **"Authentication failed"**: Ensure `id-token: write` permission is set for OIDC, or check secrets - **"Package validation failed"**: Verify your package published to your registry (NPM, PyPi etc.) successfully first, and that you have done the necessary validation steps in the [Publishing Tutorial](publish-server.md) \ No newline at end of file From 5795d800e5d1dcb2086ce1c7b081fdf91a08bcda Mon Sep 17 00:00:00 2001 From: Radoslav Dimitrov Date: Mon, 29 Sep 2025 23:44:49 +0300 Subject: [PATCH 3/3] Add the mcp-publish-action to community-projects.md Signed-off-by: Radoslav Dimitrov --- docs/community-projects.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/community-projects.md b/docs/community-projects.md index 7f405f052..f43e52f35 100644 --- a/docs/community-projects.md +++ b/docs/community-projects.md @@ -5,6 +5,7 @@ The following is a list of notable community-driven projects in the ecosystem re ## Featured Projects - [TeamSparkAI: Tool Catalog](https://github.com/TeamSparkAI/ToolCatalog) - Browse and discover servers from the official MCP Registry +- [OtherVibes/mcp-publish-action](https://github.com/OtherVibes/mcp-publish-action) - GitHub Action for publishing MCP servers to the official registry - Add your project here! ## Adding Your Project