Port MCP 服务器

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

使用 Port MCP 可以做什么

用自然语言改变您与 Port.io 的工作方式：

快速查找信息

• 获取实体详情 - “服务 X 的所有者是谁？”
• 检查值班状态 - “现在谁在值班？”
• 获取目录洞察 - “我们在生产环境中有多少个服务？”

分析记分卡

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

创建资源

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

我们正在不断扩展 Port MCP 的功能。有任何建议吗？我们非常希望听到您对我们路线图的反馈！

安装

获取您的 Port 凭证

1. 创建一个 Port.io 账户：

   • 访问 Port.io
   • 如果您还没有账户，请注册一个

2. 创建一个 API 密钥：

   • 进入您的 Port.io 仪表板
   • 转到设置 > 凭证
   • 保存客户端 ID 和客户端密钥

Claude 桌面版

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

{
  "mcpServers": {
    "port": {
      "command": "uvx",
      "args": [
        "mcp-server-port@0.1.4",
        "--client-id", "YOUR_CLIENT_ID",
        "--client-secret", "YOUR_CLIENT_SECRET",
        "--region", "REGION" # US or EU
      ]
    }
  }
} 

Cursor

1. 确保已安装 uvx：

pip install uvx

1. 获取其位置：

which uvx
# Example output: /Users/janedoe/.local/bin/uvx

1. 创建一个脚本来运行服务器：

# run-port-mcp.sh

cd /Users/janedoe/.local/bin/uvx

# Run the server with the specified credentials
./.venv/bin/uvx mcp-server-port@0.1.4 --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --region YOUR_REGION

1. 使其可执行：

chmod +x /path/to/your/file/run-port-mcp.sh

1. 在 Cursor 设置中配置：
   • 转到 Cursor 设置 > MCP 服务器
   • 配置为：
     • 名称 - Port
     • 类型 - 命令
     • 命令 - /path/to/your/file/run-port-mcp.sh

可用工具

蓝图工具

1. get_blueprints

   • 从 Port 获取所有蓝图的列表
   • 可选输入：
     • detailed（布尔值，默认：false）：返回每个蓝图的完整架构细节
   • 返回：所有可用蓝图的格式化文本表示

2. get_blueprint

   • 通过标识符检索特定蓝图的信息
   • 必需输入：
     • blueprint_identifier（字符串）：要检索的蓝图的唯一标识符
   • 可选输入：
     • detailed（布尔值，默认：true）：返回完整的架构细节

记分卡工具

1. get_scorecards

   • 从 Port 检索所有记分卡
   • 可选输入：
     • detailed (布尔值，默认: false): 返回完整的记分卡详情

2. get_scorecard

   • 根据标识符检索特定记分卡的信息
   • 必需输入：
     • scorecard_id (字符串): 要检索的记分卡的唯一标识符
     • blueprint_id (字符串, 可选): 记分卡所属蓝图的标识符

3. create_scorecard

   • 为特定蓝图创建新的记分卡
   • 必需输入：
     • blueprint_id (字符串): 创建记分卡的蓝图标识符
     • identifier (字符串): 新记分卡的唯一标识符
     • title (字符串): 记分卡的显示标题
     • levels (列表): 记分卡级别的列表
   • 可选输入：
     • rules (列表): 记分卡规则的列表
     • description (字符串): 记分卡的描述

反馈和路线图

我们正在不断改进 Port MCP，并非常希望听到您的声音！请在我们的路线图页面上分享您的反馈和功能请求。

故障排除

如果您遇到身份验证错误，请确认以下几点：

1. 您的 Port 凭证已在参数中正确设置
2. 您具有必要的权限
3. 凭证已正确复制到您的配置中

许可证

此 MCP 服务器根据 MIT 许可证获得许可。这意味着您可以自由地使用、修改和分发该软件，但必须遵守 MIT 许可证的条款和条件。有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。