秋逸

PrimeVue MCP 配置完启动不了

杨秋逸 · 2026-07-03

PrimeVue MCP 配置完启动不了

按官方文档把 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
		}
	}
}

参考