机械mcp
任务库和文档的机械MCP服务器。专为编写和自定义Mechanic任务而构建（Shopify自动化应用程序：https://apps.shopify.com/mechanic).默认情况下离线（捆绑数据），为任务提供公共URL(https://tasks.mechanic.dev)和文档(https://learn.mechanic.dev).
用户指南
- 要求：Node.js 18+，支持MCP的客户端（Cursor、Claude Desktop、Codex、Gemini CLI等）。
- 你可以问：找任务；获取任务代码（订阅+脚本/JS块）；查找文档；建议类似的任务；获取文档内容；帮助编写或定制机修工任务。
- 设置（使用
npx @lightward/mechanic-mcp@latest):
- 光标：
{
"mcpServers": {
"mechanic-mcp": {
"command": "npx",
"args": ["-y", "@lightward/mechanic-mcp@latest"]
}
}
}- 克劳德桌面：
{
"mcpServers": {
"mechanic-mcp": {
"command": "npx",
"args": ["-y", "@lightward/mechanic-mcp@latest"]
}
}
}- 食品法典委员会(~/.codex/config.toml):
[mcp_servers.mechanic-mcp]
command = "npx"
args = ["-y", "@lightward/mechanic-mcp@latest"]- Gemini CLI：与Cursor/Claude相同的JSON。
- 工具：
- search_tasks：返回公共URL、标记、订阅/subscriptions_template、选项。 - search_docs：返回公共URL/sourceUrl。 - get_task （仅限任务）：脚本+订阅+选项+JS块；不是完整的JSON。 - get_doc （仅限文档）：完全降价。 - similar_tasks：按标签/订阅/标题列出的相关任务。 - refresh_index：rebuild（打包数据不需要）。
- 使用说明：引用公共URL（无本地路径/.md）；在代码中更喜欢GraphQL；共享代码时，返回订阅+脚本/JS（相关位），而不是完整的JSON。
对于维护人员
- 捆绑数据：
dist/data/index.json.gz,records.json.gz,manifest.json（用户不需要源代码仓库）。 - 重新生成（如果需要）：
MECHANIC_DOCS_PATH=/path/to/mechanic-docs MECHANIC_TASKS_PATH=/path/to/mechanic-tasks npm run build:data
npm run build- 测验：
npm run test:smoke,npm run test:smoke-doc,npm run test:smoke-task. - 发布：凹凸版本，
npm publish（使用--access public对于作用域包）。
Env（可选）
MECHANIC_DATA_PATH（默认值dist/data),MECHANIC_DOCS_PATH,MECHANIC_TASKS_PATH，仓库URL/分支，同步间隔。
运行时
- 从加载捆绑索引/记录
MECHANIC_DATA_PATH;refresh_index如果您选择参与，则进行重建。Stdio运输；TF-IDF模糊+分页搜索；没有网络调用搜索/资源。