MCP 服务器工具集

这是一个基于 Model Context Protocol 的服务器工具集，提供多种功能来辅助开发和维护工作。

功能概览

基本工具

• 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 - 根据Key查询特定翻译项目
• localizationSearch - 搜索包含特定文字的翻译项目
• localizationAdd - 新增一个完整的翻译项目
• localizationUpdate - 更新现有翻译项目的内容
• localizationDelete - 删除指定Key的翻译项目
• localizationExportJson - 将特定语言的翻译导出为JSON格式
• localizationFindMissing - 查找有Key值但缺少特定语言翻译的项目
• localizationFindLongValues - 查找超过特定字数的翻译项目

任务管理器工具

• taskCreate - 创建新的任务，可以包含多个步骤
• taskGetAll - 获取所有任务列表
• taskGetById - 根据ID获取特定任务
• taskUpdate - 更新现有任务信息
• taskDelete - 删除指定ID的任务
• taskStepUpdate - 更新任务的特定步骤
• taskStepAdd - 为任务添加新步骤
• taskStepDelete - 删除任务的特定步骤
• taskSearch - 根据条件搜索任务
• taskAnalyze - 获取任务状态分析报告
• taskSetAllSteps - 设定某个任务所有步骤的完成状态
• taskGenerateReport - 生成任务进度Markdown报告

文件操作工具详细说明

fileWrite

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

fileWrite({
  filePath: "path/to/file.txt",
  content: "This is the 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: "// Math utility functions\n"
});

// 删除档案中的特定内容
delete_from_file({
  path: "src/utils/helper.ts",
  selector: "// Math utility functions\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"
});

注意事项

1. codeFileRead、codeLineInsert 和 codeLineDelete 工具主要用于代码编辑，而新的文件工具（fileWrite、fileRead 等）更为通用，可用于任何类型的文本文件。

2. 使用 edit_file、insert_to_file 和 delete_from_file 工具时，建议先启用 dryRun 模式来预览变更，确保操作不会造成意外的修改。

3. 文件路径可以是相对路径或绝对路径。

4. 进行批次操作时，建议使用 edit_file 工具，可以在一次调用中进行多个编辑操作。