Skill Wiki v0.1.0

文档 / implementation / mcp-server

本页目录

MCP server

Model Context Protocol 是这一层的集成面。@skill-wiki/mcp-server-core 是一个通用的、领域无关的 MCP server, 把运行时包起来,对外暴露 5 个工具。

5 个工具

工具输入输出用途
prime_query{ scope, level, tags, budget_tokens }{ hits: [{ id, kind, path, tokens }] }搜排序后的原子。
prime_resolve{ brief, max_tokens }加上已契约化的集合brief 转排序后的原子(L1 + L2 + L3)。
prime_intent{ brief }IntentObjectbrief 转 IntentObject(L1)。
prime_validate{ artifact, atom_set }{ ok, fixes }校验输出(L5)。
prime_compile{ source }编译产物临时编译一份 .prime

启动

# Standalone (stdio transport)
PRIME_DIR=/abs/path/to/compiled bunx @skill-wiki/mcp-server-core

# Via the prime CLI
prime mcp serve --port stdio --dir /abs/path/to/compiled

接入 Claude Code

{
  "mcpServers": {
    "skill-wiki": {
      "command": "bunx",
      "args": ["@skill-wiki/mcp-server-core"],
      "env": { "PRIME_DIR": "/abs/path/to/compiled" }
    }
  }
}

Server 架构

工具的输入输出 JSON Schema

每个工具都带自己的 JSON Schema,启动时注册到 MCP SDK 上。

领域定制 MCP wrapper

@skill-wiki/mcp-server-core 是领域无关的。某个领域可能想要一个 wrapper,再加上:

  • 领域定制的工具名(frontend_color_checksecurity_threat_model)。
  • 预置好的 persona 加 style 标签集合。
  • 领域定制的 L5 validator。

参考 frontend Prime 自带 @skill-wiki/mcp-server-frontend,正是这种 wrapper。