PrimeVue MCP 配置完启动不了

约 2 分钟 #开发
杨秋逸
杨秋逸

按官方文档把 PrimeVue MCP 配到 opencode 里报错:

Error: Tool get_composable expected a Zod schema or ToolAnnotations,
but received an unrecognized object
    at McpServer.tool (node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js:688:27)
    at F (node_modules/@primeuix/mcp/dist/index.js:232:4752)

原因

@primevue/mcp@primeuix/mcp@modelcontextprotocol/sdk

@primeuix/mcp 声明了对 SDK 的依赖 ^1.24.3,npx 没有 lockfile,每次都拉 semver 范围内最新的。1.29.0 改了 McpServer.tool() 的入参类型,但 @primeuix/mcp 还在按旧签名传参。

修复

-p 固定 SDK 版本,不让 npx 拉最新版:

{
    "mcp": {
        "primevue": {
            "type": "local",
            "command": [
                "npx",
                "-y",
                "-p",
                "@modelcontextprotocol/sdk@1.26.0",
                "-p",
                "@primevue/mcp@latest",
                "primevue-mcp"
            ],
            "enabled": true
        }
    }
}

参考