Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SVP-MCP check project status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Semantic Voxel Protocol - MCP Server
SVP 的 Model Context Protocol 实现，让 AI 编辑器 (Cursor, Claude Code, Windsurf 等) 能够与 SVP 项目集成。
📊 项目状态查询 - 查看编译层级和文件状态
🔧 AI 编译 - 从编辑器触发 L5→L1 编译
📋 Block 列表 - 列出所有逻辑块
🔍 Block 详情 - 查看特定块的实现代码
📁 Resources - 暴露项目上下文作为 MCP Resources
Related MCP server: Project Management AI MCP
npm install -g @semanticvoxelprotocol/mcp-server创建 .cursor/mcp.json:
{
"mcpServers": {
"svp": {
"command": "npx",
"args": ["@semanticvoxelprotocol/mcp-server", "--project", "."]
}
}
}Claude Code 会自动发现 MCP servers，或手动添加：
# 在项目目录运行
npx @semanticvoxelprotocol/mcp-server --project .任何支持 MCP 的编辑器都可以使用 stdio 传输层连接：
svp-mcp --project /path/to/projectsvp_status获取项目编译状态
{
"name": "svp_status",
"arguments": {}
}svp_compileAI 编译指定层级
{
"name": "svp_compile",
"arguments": {
"level": 5 // 5|4|3|2
}
}svp_compile_allAI 编译所有层级 (L5→L1)
{
"name": "svp_compile_all",
"arguments": {}
}svp_list_blocks列出逻辑块
{
"name": "svp_list_blocks",
"arguments": {
"level": 3 // 3|2|1, default: 3
}
}svp_get_block获取特定块内容
{
"name": "svp_get_block",
"arguments": {
"blockId": "validate_order_input",
"level": 1 // 1|2, default: 1
}
}URI | 描述 |
| 项目上下文和状态 |
| L5 蓝图 (YAML) |
| L4 架构流程 (YAML) |
| L3 领域模型 (YAML) |
| L1 实现代码 (TypeScript) |
在 Cursor 或 Claude Code 中：
> 查看 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 │
└─────────────┘MIT
This server cannot be deployed
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
MCP-native collaborative markdown editor with real-time AI document editing
Generate AI images and videos from any compatible MCP client.
