Port MCP 服务器

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

您可以使用 Port MCP 做什么

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

快速查找信息

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

分析记分卡

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

创建资源

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

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

安装

获取您的 Port 凭据

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

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

2. 创建一个 API 密钥：

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

Claude Desktop

将以下内容添加到您的 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

2. 获取其位置：

which uvx
# 示例输出：/Users/janedoe/.local/bin/uvx

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

# run-port-mcp.sh

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

# 使用指定的凭据运行服务器
./.venv/bin/uvx mcp-server-port@0.1.4 --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --region YOUR_REGION

4. 使其可执行：

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

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

可用工具

蓝图工具

1. get_blueprints

   • 从 Port 检索所有蓝图的列表
   • 可选输入：
     • detailed (boolean, default: false): 返回每个蓝图的完整模式详细信息
   • 返回：所有可用蓝图的格式化文本表示

2. get_blueprint

   • 按标识符检索有关特定蓝图的信息
   • 必需输入：
     • blueprint_identifier (string): 要检索的蓝图的唯一标识符
   • 可选输入：
     • detailed (boolean, default: true): 返回完整的模式详细信息

记分卡工具

1. get_scorecards

   • 从 Port 检索所有记分卡
   • 可选输入：
     • detailed (boolean, default: false): 返回完整的记分卡详细信息

2. get_scorecard

   • 按标识符检索有关特定记分卡的信息
   • 必需输入：
     • scorecard_id (string): 要检索的记分卡的唯一标识符
     • blueprint_id (string, optional): 记分卡所属的蓝图的标识符

3. create_scorecard

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

反馈和路线图

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

故障排除

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

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

许可证

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