Port MCP Server

The Port MCP Server is a natural - language interaction service designed for the Port.io developer platform, enabling fast querying, analysis, and resource creation through Claude.

Developer tools Artificial intelligence chatbots #Developer Tools #Natural Language Interaction #Resource Management #Platform Integration .Python

rating : 2.5 points

downloads : 26

update time : 2025-04-29

What is the Port MCP Server?

The Port MCP Server allows you to interact with Port.io's development platform through natural language. Whether you need to quickly find information, analyze scorecards, or create new resources, Port MCP can make your work more efficient.

How to use the Port MCP Server?

You can start using the Port MCP Server in just a few steps. First, make sure you have installed the necessary tools and obtained Port.io's API credentials. Then configure the server according to your needs and run it.

Use cases

It is suitable for enterprises and individual developers who need to quickly obtain data from the Port.io platform, especially teams that want to optimize their workflows and improve productivity.

Main Features

Quickly find informationQuickly obtain the required information through simple natural language queries, such as 'Who is the owner of Service X?'

Analyze scorecardsGain in - depth understanding of the status of scorecards, such as identifying weak points or methods to improve quality.

Create resourcesEasily create new scorecards, rules, and quality gates.

Advantages and Limitations

Advantages

Simplify complex tasks through natural language.

Support multiple operations, including querying, analyzing, and resource creation.

Highly customizable to meet different user needs.

Limitations

Some technical knowledge may be required for the initial setup.

Certain advanced features may require specific permissions.

How to Use

Visit the official Port.io website and register an account.

Generate an API key

After logging in to Port.io, generate an API client ID and client secret in the settings.

Install and configure the Port MCP Server

Install and configure the Port MCP Server according to the instructions.

Usage Examples

Query the service ownerEnter 'Who is the owner of Service X?' to get the owner information of Service X.

Create a scorecardEnter 'Create a scorecard named "Security" with basic, silver, and gold levels.' to create a new scorecard.

Frequently Asked Questions

How to obtain Port.io's API credentials?

Which operating systems does Port MCP support?

Related Resources

Port.io Official Website

Homepage of the Port.io developer platform.

GitHub Code Repository

Open - source code of the Port MCP Server.

🚀 Port MCP Server Usage Guide

Port MCP Server is a powerful tool that simplifies the management of blueprints, entities, scorecards, and more. This guide will walk you through the installation, configuration, and usage of the Port MCP Server.

🚀 Quick Start

📦 Installation

To install the Port MCP Server, follow these steps:

Prerequisites

Ensure that Python 3.8 or a higher version is installed on your system.
Install the required dependencies: pip install port-mcp

Download and Run

# Clone the repository
git clone https://github.com/your-repository.git

# Navigate to the directory
cd path/to/repository

# Start the server
python3 -m port.mcp.server

⚙️ Configuration

Configure the following parameters in the config.py file:

Port Settings

PORT = 5000

Log Level

LOG_LEVEL = "INFO"

💻 Usage Examples

Blueprint Tool

Get Blueprints
```
port-mcp get-blueprints [--detailed]
```
Get a Specific Blueprint
```
port-mcp get-blueprint blueprint_id
```

Create a Blueprint

port-mcp create-blueprint identifier title description

Update a Blueprint

port-mcp update-blueprint blueprint_id [key=value...]

Delete a Blueprint
```
port-mcp delete-blueprint blueprint_id
```

Entity Tool

Get Entities

port-mcp get-entities blueprint_id [--detailed]

Get a Specific Entity

port-mcp get-entity blueprint_id entity_id

Create an Entity

port-mcp create-entity blueprint_id entity_data

Update an Entity

port-mcp update-entity blueprint_id entity_id entity_data

Delete an Entity

port-mcp delete-entity blueprint_id entity_id [--delete-dependents]

Scorecard Tool

Get Scorecards
```
port-mcp get-scorecards [--detailed]
```

Get a Specific Scorecard

port-mcp get-scorecard scorecard_id [--blueprint_id blueprint_id]

Create a Scorecard

port-mcp create-scorecard blueprint_id identifier title levels

Update a Scorecard

port-mcp update-scorecard blueprint_id scorecard_identifier [key=value...]

Delete a Scorecard

port-mcp delete-scorecard blueprint_id scorecard_identifier

AI Agent Tool

Invoke the AI Agent
```
port-mcp invoke-ai-agent prompt
```

📚 Documentation

Feedback and Roadmap

We are constantly improving Port MCP and welcome your feedback and feature requests. Please visit our Roadmap Page to submit your suggestions.

Troubleshooting

If you encounter authentication errors, please check the following:

Ensure that your Port credentials are correctly set.
Verify that you have sufficient permissions.
Make sure that your credentials are correctly copied to the configuration file.

📄 License

The Port MCP Server is distributed under the MIT License. This means that you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the license file in the project repository.