npm install -g @semanticvoxelprotocol/mcp-server

{
  "mcpServers": {
    "svp": {
      "command": "npx",
      "args": ["@semanticvoxelprotocol/mcp-server", "--project", "."]
    }
  }
}

# 在项目目录运行
npx @semanticvoxelprotocol/mcp-server --project .

svp-mcp --project /path/to/project

{
  "name": "svp_status",
  "arguments": {}
}

{
  "name": "svp_compile",
  "arguments": {
    "level": 5  // 5|4|3|2
  }
}

{
  "name": "svp_compile_all",
  "arguments": {}
}

{
  "name": "svp_list_blocks",
  "arguments": {
    "level": 3  // 3|2|1, default: 3
  }
}

{
  "name": "svp_get_block",
  "arguments": {
    "blockId": "validate_order_input",
    "level": 1  // 1|2, default: 1
  }
}

> 查看 SVP 项目状态
使用 svp_status 工具查询项目编译状态...

✅ L1 (6 files)
✅ L2 (6 files)  
✅ L3 (6 blocks)
✅ L4
✅ L5

> 列出所有逻辑块
使用 svp_list_blocks 工具...

L3 Logic Blocks (6):
  - validate_order_input: Validate Order Input
  - call_inventory_service: Call Inventory Service
  ...

> 查看 validate_order_input 的实现
使用 svp_get_block 工具...

// L1 Block: validate_order_input
export function validateOrderInput(request: OrderRequest): ValidationResult {
  // 完整实现代码...
}

> 重新编译 L5
使用 svp_compile 工具，level=5...

✅ Successfully compiled L5 → L4

# 安装依赖
npm install

# 构建
npm run build

# 测试运行
node dist/server.js --project ../template-ts

┌─────────────────┐     ┌─────────────┐     ┌─────────────────┐
│   AI Editor     │────▶│  MCP Client │────▶│  SVP MCP Server │
│ (Cursor/Claude) │     │   (stdio)   │     │  (this package) │
└─────────────────┘     └─────────────┘     └────────┬────────┘
                                                      │
                           ┌─────────────────────────┘
                           ▼
                    ┌─────────────┐
                    │  SVP Core   │
                    │ AICompiler  │
                    └─────────────┘