Skip to content

Conversation

kodjomiles
Copy link
Collaborator

Description

Added new guide for managing MCP Server Registry with governance and automation

Added docs pages

Please also include the path for the added docs

  • Manage MCP Server Registry (/guides/all/manage-mcp-registry)

Updated docs pages

Please also include the path for the updated docs

  • None

@kodjomiles kodjomiles self-assigned this Oct 14, 2025
@kodjomiles kodjomiles added the documentation Improvements or additions to documentation label Oct 14, 2025
Copy link

This pull request is automatically being deployed by Amplify Hosting (learn more).

Access this pull request here: https://pr-2887.d2ngvl90zqbob8.amplifyapp.com

"status": {
"title": "Approval Status",
"type": "string",
"enum": ["approved", "pending", "rejected"],
Copy link
Contributor

Choose a reason for hiding this comment

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

I didn't yet read everything, but adding here approval status means you are also adding actions to request a new MCP server?

"description": "What this MCP server does and when to use it"
},
"capabilities": {
"title": "Capabilities",
Copy link
Contributor

Choose a reason for hiding this comment

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

I would name it "labels"

},
"description": "Tags representing server capabilities (e.g., java, database, testing)"
},
"installation_url": {
Copy link
Contributor

Choose a reason for hiding this comment

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

usually installation of an MCP server is complicated, and there are "tweaks" in each organization. So I feel like installation instructions is actually a markdown

"format": "url",
"description": "Source code repository location"
},
"tools": {
Copy link
Contributor

Choose a reason for hiding this comment

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

I would expect tools to be a separate blueprint and managed via relations. Please see what Sebastian built

"description": "List of MCP tools provided by this server"
},
"prompts": {
"title": "Available Prompts",
Copy link
Contributor

Choose a reason for hiding this comment

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

Same here, I would ingest prompts to the prompt blueprint (see our docs we already built a prompt blueprint you can refer to it)

"format": "date-time",
"description": "When this server was approved for use"
},
"requested_by": {
Copy link
Contributor

Choose a reason for hiding this comment

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

should be a relation if its relevant

},
"description": "List of MCP prompts provided by this server"
},
"approval_date": {
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't think its necessary

Now that we have our data model setup, let's explore how to populate and discover MCP servers in the catalog.
You can add MCP servers to your Port catalog using three methods:

<Tabs groupId="ingestion-method" defaultValue="ui" values={[
Copy link
Contributor

Choose a reason for hiding this comment

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

There's an additional method which is to run a dummy MCP client.
Sebastian built one in Java, I suggest we "migrate" it to something more generic, like python/node (depends), and see how we can incorporate this.

The idea would be:

  1. Run the server using this script/repo (Example)
  2. The client will list the server & its tools and will update Port

Replace `YOUR/SLACK/WEBHOOK` with your actual [Slack webhook URL](https://api.slack.com/messaging/webhooks).
:::

## Python script for metadata extraction
Copy link
Contributor

Choose a reason for hiding this comment

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

This sounds like yet another method to ingest MCP servers.
A script that runs over an existing repo, extract the tools & server data, and ingest into Port.

See above my comment on running the server. both options are valid.

Consider if it makes more sense for this script to be stored in port-experimental (and it could also be a repsotiry of some sort if its complex)

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants