Port MCP Server

端口 MCP 服务器

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

您可以使用 Port MCP 做什么

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

快速查找信息

• 获取实体详细信息——“谁是服务 X 的所有者？”
• 检查值班状态——“现在谁值班？”
• 获取目录见解— “我们在生产中有多少服务？”

分析记分卡

• 找出弱点——“哪些服务未达到黄金级别，为什么？”
• 获取合规状态- “显示所有不符合我们的安全要求的服务”
• 提高质量——“我需要修复什么才能达到下一个记分卡水平？”

创建资源

• 建立记分卡- “创建一个名为‘安全态势’的新记分卡，分为基本、银牌和金牌三个级别”
• 定义规则——“添加一条规则，要求服务必须有团队所有者才能达到银牌级别”
• 设置质量门- “创建检查服务是否有适当文档的规则”

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

安装

获取您的端口凭证

1. 创建 Port.io 帐户：
   • 访问Port.io
   • 如果您没有帐户，请注册一个
2. 创建 API 密钥：
   • 导航到您的 Port.io 仪表板
   • 前往“设置”>“凭证”
   • 保存客户端 ID 和客户端密钥

克劳德桌面

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

Docker

光标

在光标设置中配置：

• 前往 Cursor 设置 > MCP 服务器
• 配置：
  • 名称 - Port
  • 类型 - Command
  • 命令 - /path/to/your/file/run-port-mcp.sh

Docker

可用工具

蓝图工具

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 文件。