Skip to Content
Skip to Content
Server 与 Tools

Server 与 Tools

公开入口

mcp/src/index.ts 当前只公开两个入口:

  • createMemorySyncMcpServer
  • runMemorySyncMcpStdioServer

这说明这个包的职责非常明确,就是提供 server 构造与 stdio 运行入口。

当前已暴露的工具

mcp/src/server.ts 当前注册的工具包括:

  • list_prompts
  • get_prompt
  • upsert_prompt_src
  • apply_prompt_translation

每个工具大致负责什么

ToolCore CapabilityEntry / SurfaceNotes
list_prompts
  • 列出受管 prompt 记录
  • 返回 zh / en / dist 状态
  • MCP tool call
适合让客户端先拿全量索引,再决定读取哪个 prompt。
get_prompt
  • 读取单个 prompt
  • 返回 source 与 dist 产物
  • MCP tool call
当你需要做差异比对或精确查看内容时用它。
upsert_prompt_src
  • 更新 zh source
  • 更新 en source
  • MCP tool call
它只碰 source,不直接改 dist。
apply_prompt_translation
  • 写入外部生成的 en 内容
  • 写入外部生成的 dist 内容
  • MCP tool call
适合翻译或编译产物已经在外部生成完成之后回写。

workspaceDir 的作用

这些工具都接受可选的 workspaceDir。它的语义不是“随便切目录”,而是把 prompt service 的项目根显式绑定到某个项目上下文。

如果不传,server 会按默认当前工作目录解释;如果传入,则会同时进入 cwdpluginOptions.workspaceDir

使用边界

  • 先保证 CLI 侧的项目结构是正确的,再接入 MCP
  • MCP 只暴露当前已有的 prompt 管理行为,不替你发明新的 Schema
  • 需要确认 prompt 类型与真源职责时,回看 技术细节
Last updated on