端口 MCP 服务器

Port.io API的模型上下文协议 (MCP) 服务器，使 Claude 能够使用自然语言与 Port.io 的开发者平台功能进行交互。

您可以使用 Port MCP 做什么

使用自然语言改变您使用 Port.io 的方式：

快速查找信息

• 获取实体详细信息——“谁是服务 X 的所有者？”

• 检查值班状态——“现在谁值班？”

• 获取目录见解— “我们在生产中有多少服务？”

分析记分卡

• 找出弱点——“哪些服务未达到黄金级别，为什么？”

• 获取合规状态- “显示所有不符合我们的安全要求的服务”

• 提高质量——“我需要修复什么才能达到下一个记分卡水平？”

创建资源

• 建立记分卡- “创建一个名为‘安全态势’的新记分卡，分为基本、银牌和金牌三个级别”

• 定义规则——“添加一条规则，要求服务必须有团队所有者才能达到银牌级别”

• 设置质量门- “创建检查服务是否有适当文档的规则”

我们正在不断扩展 Port MCP 的功能。有什么建议吗？我们期待听到您对我们路线图的反馈！

Related MCP server: MCP Server

安装

获取您的端口凭证

1. 创建 Port.io 帐户：

   • 访问Port.io

   • 如果您没有帐户，请注册一个

2. 创建 API 密钥：

   • 导航到您的 Port.io 仪表板

   • 前往“设置”>“凭证”

   • 保存客户端 ID 和客户端密钥

克劳德桌面

将以下内容添加到您的claude_desktop_config.json中：

Docker

{
  "mcpServers": {
    "port": {
      "command": "docker",
      "args": [
               "run",
                "-i",
                "--rm",
                "-e",
                "PORT_CLIENT_ID",
                "-e",
                "PORT_CLIENT_SECRET",
                "-e",
                "PORT_REGION",
                "-e",
                "PORT_LOG_LEVEL",
                "ghcr.io/port-labs/port-mcp-server:0.2.1"
              ],
              "env": {
                "PORT_CLIENT_ID": "<PORT_CLIENT_ID>",
                "PORT_CLIENT_SECRET": "<PORT_CLIENT_SECRET>",
                "PORT_REGION": "<PORT_REGION>",
                "PORT_LOG_LEVEL": "<PORT_LOG_LEVEL>"
              }
    }
  }
}

光标

在光标设置中配置：

• 前往 Cursor 设置 > MCP 服务器

• 配置：

  • 名称 - Port

  • 类型 - Command

  • 命令 - /path/to/your/file/run-port-mcp.sh

Docker

{
    "mcpServers": {
        "port": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "PORT_CLIENT_ID",
                "-e",
                "PORT_CLIENT_SECRET",
                "-e",
                "PORT_REGION",
                "-e",
                "PORT_LOG_LEVEL",
                "ghcr.io/port-labs/port-mcp-server:0.2.1"
            ],
            "env": {
                "PORT_CLIENT_ID": "<PORT_CLIENT_ID>",
                "PORT_CLIENT_SECRET": "<PORT_CLIENT_SECRET>",
                "PORT_REGION": "<PORT_REGION>",
                "PORT_LOG_LEVEL": "<PORT_LOG_LEVEL>"
            }
        }
    }
}

可用工具

蓝图工具

1. get_blueprints

   • 从港口检索所有蓝图的列表

   • 可选输入：

     • detailed （布尔值，默认值：false）：返回每个蓝图的完整架构详细信息。

   • 返回：所有可用蓝图的格式化文本表示

2. get_blueprint

   • 通过标识符检索特定蓝图的信息

   • 必需输入：

     • blueprint_identifier （字符串）：要检索的蓝图的唯一标识符

   • 可选输入：

     • detailed （布尔值，默认值：true）：返回完整的架构详细信息

3. create_blueprint

   • 在港口创建新蓝图

   • 必需输入：

     • 包括标识符、标题、属性等各种字段。

   • 返回：创建的蓝图对象

4. update_blueprint

   • 更新现有蓝图

   • 必需输入：

     • identifier （字符串）：要更新的蓝图的唯一标识符

     • 需要更新的各个字段

   • 返回：更新后的蓝图对象

5. delete_blueprint

   • 从端口删除蓝图

   • 必需输入：

     • blueprint_identifier (string)：要删除的蓝图的唯一标识符

   • 返回：成功状态

实体工具

1. get_entities

   • 检索给定蓝图的所有实体

   • 必需输入：

     • blueprint_identifier (string): 获取实体的蓝图标识符

   • 可选输入：

     • detailed （布尔值，默认值：false）：返回包括属性在内的完整实体详细信息。

2. get_entity

   • 检索有关特定实体的信息

   • 必需输入：

     • blueprint_identifier (字符串)：实体所属蓝图的标识符

     • entity_identifier （字符串）：要检索的实体的唯一标识符

   • 可选输入：

     • detailed （布尔值，默认值：true）：返回完整的实体详细信息

3. create_entity

   • 为特定蓝图创建新实体

   • 必需输入：

     • blueprint_identifier (string)：用于创建实体的蓝图的标识符

     • entity （对象）：遵循蓝图模式的实体数据

4. update_entity

   • 更新现有实体

   • 必需输入：

     • blueprint_identifier (字符串)：实体所属蓝图的标识符

     • entity_identifier （字符串）：要更新的实体的唯一标识符

     • entity （对象）：更新后的实体数据

5. delete_entity

   • 删除实体

   • 必需输入：

     • blueprint_identifier (字符串)：实体所属蓝图的标识符

     • entity_identifier （字符串）：要删除的实体的唯一标识符

   • 可选输入：

     • delete_dependents （布尔值，默认值：false）：如果为 true，则还会删除所有依赖项

记分卡工具

1. get_scorecards

   • 从港口检索所有记分卡

   • 可选输入：

     • detailed （布尔值，默认值：false）：返回完整的记分卡详细信息

2. get_scorecard

   • 通过标识符检索特定记分卡的相关信息

   • 必需输入：

     • scorecard_id （字符串）：要检索的记分卡的唯一标识符

     • blueprint_id （字符串，可选）：记分卡所属蓝图的标识符

3. create_scorecard

   • 为特定蓝图创建新的记分卡

   • 必需输入：

     • blueprint_id （字符串）：用于创建记分卡的蓝图的标识符

     • identifier （字符串）：新记分卡的唯一标识符

     • title （字符串）：记分卡的显示标题

     • levels （列表）：记分卡的级别列表

   • 可选输入：

     • rules （列表）：记分卡规则列表

     • description （字符串）：记分卡的描述

4. update_scorecard

   • 更新现有记分卡

   • 必需输入：

     • blueprint_identifier (字符串)：记分卡所属蓝图的标识符

     • scorecard_identifier （字符串）：要更新的记分卡的唯一标识符

     • 要更新的各个字段（标题、级别、规则等）

   • 返回：更新后的记分卡对象

5. delete_scorecard

   • 从端口删除记分卡

   • 必需输入：

     • blueprint_identifier (字符串)：记分卡所属蓝图的标识符

     • scorecard_identifier （字符串）：要删除的记分卡的唯一标识符

   • 返回：成功状态

AI代理工具

1. invoke_ai_agent

   • 使用特定提示调用 Port AI 代理

   • 必需输入：

     • prompt （字符串）：发送给 AI 代理的提示

   • 返回：来自 AI 代理的调用状态和消息

反馈和路线图

我们正在不断改进 MCP 端口，期待您的反馈！请在我们的路线图页面分享您的反馈和功能需求。

故障排除

如果遇到身份验证错误，请验证：

1. 您的端口凭据已在参数中正确设置

2. 您拥有必要的权限

3. 凭证已正确复制到您的配置中

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。