Microtoll Engine

Name: Microtoll Engine
Author: microtoll

本地服务

microtoll.dev开发工具14 周前更新

代码仓库访问官网

关于 Microtoll Engine

Microtoll Engine 是面向编码工具的 MCP 服务，提供内置文档和用于引擎应用的起始项目模板。其工具可搜索或读取本地文档，也可在空目录中创建文件，全程不访问网络。

主要功能

01全文搜索内置文档
02以 Markdown 读取文档页面
03在空目录中创建 notes 应用模板
04填入 namespace、origin 等模板值
05拒绝非空目录且不覆盖文件

适用场景

01在编码工具中查找 Microtoll Engine 文档
02在编辑器中阅读引用的文档页面
03从生成的起始文件开始构建引擎项目

MCP 相关

通过标准输入和输出实现 MCP，向兼容主机提供文档搜索、页面读取和项目模板生成三种工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "microtoll": {
      "command": "npx",
      "args": [
        "-y",
        "@microtoll/mcp"
      ]
    }
  }
}

启动命令npx -y @microtoll/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@microtoll/mcp0.1.3stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
limit	integer	否
query	string	是	要查找的内容，用词语描述。

详细介绍

@microtoll/mcp

将 Microtoll Engine 集成到你的编码工具中。这是一个模型上下文协议服务（通过标准输入和输出通信），Claude Code、Cursor 及任何 MCP 宿主都可以调用它，以获取引擎文档和项目脚手架，让 Agent 无需离开编辑器即可接入引擎；也无需离开本机：页面随包提供，不会获取任何内容，除了 src/ 中的内容外，不会运行任何代码。

状态： 已以 @microtoll/mcp 的名称发布到 npm，并在 MCP 注册表中列为 io.github.microtoll/mcp。Apache-2.0。零依赖。Node 24 或更高版本。

添加到宿主

claude mcp add microtoll -- npx -y @microtoll/mcp

其他宿主也使用相同的命令（npx -y @microtoll/mcp）作为 stdio 服务。

三种工具

工具	功能
`microtoll_search_docs({ query, limit? })`	对文档进行全文搜索——与 microtoll.dev 上相同的页面，由仓库的文档构建流程打包在 `generated/docs.json` 中，因此内容始终一致。返回页面、章节和摘录。
`microtoll_read_doc({ path })`	根据搜索结果提供的 `path`（`packages/access.html`）或 `llms.txt`，以 Markdown 格式读取单个页面。
`microtoll_scaffold({ directory, namespace?, origin?, name? })`	将 notes 起始模板写入空目录：`notes.js`、`page.js`、`index.html`、`docker-compose.yml`、`nginx.conf`、`package.json`、`README.md`，并填入 namespace 和 origin。只写入文件，不做其他操作；目录非空时会拒绝执行；绝不覆盖文件。后续步骤（`npm install`、`docker compose up`）会以文本形式返回，供用户执行。

每种工具还带有纯文本 title 和规范中的行为提示（annotations），宿主可据此决定是否先征求用户同意。两个文档工具只读取内容；脚手架工具会写入文件，但只会添加文件（不会删除或覆盖），使用相同参数再次调用也不会产生变化；这三种工具都不会使用网络。

通信内容

JSON-RPC 2.0，每行一条消息：initialize（协议版本 2025-06-18，tools capability）、ping、tools/list、tools/call；收到通知时不作响应；工具执行失败时，工具结果会带有 isError；协议错误则返回 JSON-RPC 错误。src/protocol.js 中约 120 行代码，并通过宿主发送内容的交互记录进行测试。