# CocosMetaMCP · MCP 服务（stdio v2）



分层 MCP：**默认 1 个 tool**（`cocosmcp_exec`），插件与 recipe 按需启用。



```powershell

cd mcp && npm install

```



## 层级



| 层 | 开关 | 暴露内容 |

|----|------|----------|

| **Core** | 始终 | `cocosmcp_exec`（可选 `cocosmcp_health`） |

| **Recipe L1** | `COCOSMCP_RECIPE_LAYER=1` | stats、list/register/run recipe、plugin 管理 |

| **Recipe L2** | `COCOSMCP_RECIPE_LAYER=2` | + promote/demote/unregister、恢复 promoted |

| **Plugins** | `{tmpdir}/cocos-meta-mcp/load.json` + npm 内置 | 自研插件在 user store，不在 npm 包 |



## 插件



```text

mcp/plugins/

  asset-meta/    # 3 tools
  asset-sync/    # 1 tool
  {your-plugin}/ # 自研插件（可选，见 docs/PLUGINS.md）

```



## 快速 env



```json

{}

```



```json

{ "COCOSMCP_PLUGINS": "asset-meta,asset-sync" }

```



```json

{ "COCOSMCP_TOOL_PROFILE": "full" }

```



配置示例：`../examples/cursor-mcp-layered.json`  

架构说明：`../docs/LAYERS.md`