Port MCP Server

简介

Port MCP 服务器允许 Claude 与 Port.io 开发者平台集成，实现直接交互。

安装前准备

1. 获取 Port.io 凭证

• 在 Port.io 创建账户
• 前往设置 > 凭证获取客户端 ID 和密钥

安装选项

A. Claude 桌面版

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "port": {
      "command": "uvx",
      "args": [
        "mcp_server_port",
        "--client-id", "YOUR_CLIENT_ID",
        "--client-secret", "YOUR_CLIENT_SECRET",
        "--region", "YOUR_REGION" // US 或 EU
      ]
    }
  }
}

B. Cursor 集成

1. 安装 uvx：

   pip install uvx
   

2. 创建运行脚本 (run-port-mcp.sh)：

   #!/bin/bash
   
   # 获取 uvx 路径
   UVX_PATH=$(which uvx)
   
   # 运行服务器
   $UVX_PATH mcp_server_port --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --region YOUR_REGION
   

3. 使脚本可执行：

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

4. 在 Cursor 设置 > MCP 服务器中配置：

   • 名称：Port
   • 类型：命令
   • 命令：/path/to/run-port-mcp.sh

主要功能

代理工具

• trigger_port_agent：通过提示触发 Port.io AI 代理

  输入：prompt (字符串)
  

蓝图工具

• get_blueprints：获取蓝图列表

  可选输入：detailed (布尔值)
  

• get_blueprint：获取特定蓝图信息

  输入：blueprint_identifier (字符串)
  可选输入：detailed (布尔值)
  

故障排除

如遇连接问题，请检查：

1. 凭证是否正确输入
2. 是否选择了正确的区域 (US/EU)
3. 账户是否有足够权限

许可

本项目基于 MIT 许可证开源。