工单MC工具

Name: 工单MC工具
Author: GonTwVn

作者：GonTwVn5 星标更新：2025-04-30

安装使用来源：spider==github.com

项目介绍

MCP 服务器工具集

该工具集基于模型上下文协议，提供多种功能以协助开发和维护工作。

功能概览

基础工具

add -简单的加法计算工具
npmBuild -执行 npm build 命令构建项目
npmInstall -执行 npm install 命令安装依赖

归档操作工具

codeFileRead -读取代码文件并显示行号
codeLineInsert -在代码文件的指定行插入内容
codeLineDelete -删除代码文件内指定范围的行
fileWrite -归档写入功能，提供创建、编辑和写入功能
fileRead -读取文件内容，支持纯文本和 JSON 格式
edit_file -精确编辑归档，可以替换特定文本内容
insert_to_file -在文件的特定位置插入新内容
delete_from_file -从归档中删除特定内容

搜索工具

find_files -搜索允许目录下匹配文件名模式的文件
search_code -搜索允许目录下包含特定文本的代码

本地化应用

localizationGetByKey -根据键查询特定翻译项目
localizationSearch -搜索包含特定文本的翻译项目
localizationAdd -添加完整的翻译项目
localizationUpdate -更新现有翻译项目的部分内容
localizationDelete -删除指定键的翻译项目
localizationExportJson -导出特定语言的翻译为 JSON 格式
localizationFindMissing -搜索有值但缺少特定语言翻译的键项目
localizationFindLongValues -搜索超过特定字数的翻译项目

任务管理工具

taskCreate -创建涉及多个步骤的新任务
taskGetAll -获取所有任务列表
taskGetById -根据ID获取特定任务
taskUpdate -更新现有任务信息
taskDelete -删除指定ID的任务
taskStepUpdate -更新任务的具体步骤
taskStepAdd -向任务中添加新的步骤
taskStepDelete -删除任务的具体步骤
taskSearch -根据条件搜索任务
taskAnalyze -获取任务状态分析报告
taskSetAllSteps -设置任务中所有步骤的完成状态
taskGenerateReport -生成任务进度Markdown报告
taskGuidanceRead -读取AI任务指导文档
taskGuidanceWrite -写入AI任务指导文档
Make the window not appear in tasklists -启动任务
taskComplete -完成任务

归档操作工具详细描述

fileWrite

提供文件写入功能，可以创建新文件或修改现有文件。

fileWrite({
  filePath: "path/to/file.txt",
  content: "这是内容",
  mode: "write", // 可选值: write, append, json
  createDirs: true, // 可选，是否自动创建目录
  prettify: true // 可选，仅对json模式有效，是否美化JSON输出
})

fileRead

读取文件内容，支持纯文本和 JSON 格式。

fileRead({
  filePath: "path/to/file.txt",
  mode: "text", // 可选值: text, json
  encoding: "utf8" // 可选，指定编码方式
})

edit_file

精确编辑归档，可以替换特定文本内容。

edit_file({
  path: "path/to/file.txt",
  edits: [
    {
      oldText: "要替换的文字",
      newText: "替换后的文字"
    }
  ],
  dryRun: false // 可选，预览变更而不实际修改文件
})

insert_to_file

在文件的特定位置插入新内容。

insert_to_file({
  path: "path/to/file.txt",
  position: 10, // 行号 (从1开始)，或标记文字
  content: "要插入的内容",
  dryRun: false // 可选，预览变更而不实际修改文件
})

delete_from_file

从归档中删除特定内容。

delete_from_file({
  path: "path/to/file.txt",
  selector: "要删除的文字", // 或 {startLine:  5, endLine: 10} 或 {start: "开始标记", end: "结束标记"}
  dryRun: false // 可选，预览变更而不实际修改文件
})

使用示例

创建和编辑归档

// 创建一个新的 TypeScript 文件
fileWrite({
  filePath: "src/utils/helper.ts",
  content: `export function add(a: number, b: number): number {
  return a + b;
}`,
  mode: "write"
});

// 读取文件内容
fileRead({
  filePath: "src/utils/helper.ts",
  mode: "text"
});

// 编辑文件中的特定文字
edit_file({
  path: "src/utils/helper.ts",
  edits: [
    {
      oldText: "export function add",
      newText: "export function sum"
    }
  ]
});

// 在文件中插入新内容
insert_to_file({
  path: "src/utils/helper.ts",
  position: 1, // 在第一行插入
  content: "// 数学实用函数\n"
});

// 删除文件中的特定内容
delete_from_file({
  path: "src/utils/helper.ts",
  selector: "// 数学实用函数\n"
});

使用 JSON 模式

// 创建 JSON 配置文件
fileWrite({
  filePath: "config.json",
  content: '{"version": "1.0.0", "debug": false}',
  mode: "json",
  prettify: true
});

// 读取 JSON 文件
fileRead({
  filePath: "config.json",
  mode: "json"
});

注意事项

codeFileRead、codeLineInsert 和 codeLineDelete 工具主要用于代码编辑，而新的归档工具（fileWrite 和 fileRead）更具通用性，可用于任何类型的文本文件。
使用 edit_file、insert_to_file 和 delete_from_file 工具时，建议先启用 dryRun 模式预览更改，确保操作不会导致意外修改。
文件路径可以是相对路径或绝对路径。
执行批量操作时，建议使用 edit_file 工具，可以在一次调用中执行多次编辑操作。