AI导哈

Mechanic任务库服务器

用于Mechanic任务库和文档的服务器，支持查找任务、获取任务代码、搜索文档及帮助编写或自定义Mechanic任务。

  • by lightward
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 lightward/mechanic-mcp

使用说明

机械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模糊+分页搜索；没有网络调用搜索/资源。

相关 MCP