search_and_replace
Find and replace text in Word documents to update content, correct errors, or standardize terminology across files.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filePath | Yes | ||
| searchText | Yes | ||
| replaceText | Yes | ||
| matchCase | No |
Implementation Reference
- src/services/DocumentService.ts:153-189 (handler)Core handler function that implements the search and replace logic: reads document text using mammoth, performs regex replace, and rewrites the document using docx Packer.async searchAndReplace(filePath: string, options: SearchReplaceOptions): Promise<APIResponse> { try { const buffer = await fs.readFile(filePath); const result = await mammoth.extractRawText({ buffer }); let content = result.value; const searchRegex = new RegExp( options.searchText, `g${options.matchCase ? '' : 'i'}` ); const matches = content.match(searchRegex) || []; content = content.replace(searchRegex, options.replaceText); // 注意：这里需要重新创建文档，因为 mammoth 主要用于读取 const doc = new Document({ sections: [{ children: [new Paragraph({ text: content })], }], }); await Packer.toBuffer(doc).then((buffer) => { return fs.writeFile(filePath, buffer); }); return { success: true, data: { matchCount: matches.length, preview: content.substring(0, 200) + '...', }, }; } catch (error) { const err = error as Error; return { success: false, error: `查找替换失败: ${err.message}` }; } }
- src/types/index.ts:45-49 (schema)TypeScript interface defining the input options for the search_and_replace tool.export interface SearchReplaceOptions { searchText: string; replaceText: string; matchCase?: boolean; }
- src/mcp-server.ts:122-148 (registration)MCP server tool registration using Zod schema, with handler wrapper calling DocumentService.searchAndReplace.server.tool( "search_and_replace", { filePath: z.string(), searchText: z.string(), replaceText: z.string(), matchCase: z.boolean().optional(), }, async (params) => { const result = await docService.searchAndReplace(params.filePath, { searchText: params.searchText, replaceText: params.replaceText, matchCase: params.matchCase, }); return { content: [ { type: "text", text: result.success ? `替换完成: ${result.data.matchCount} 处匹配\n预览: ${result.data.preview}` : result.error!, }, ], isError: !result.success, }; } );
- src/server.ts:67-80 (registration)HTTP server tool registration in tools array with inline JSON schema, dispatched later to DocumentService.{ name: 'search_and_replace', description: '查找并替换文本', parameters: { properties: { filePath: { type: 'string', description: '文档路径' }, searchText: { type: 'string', description: '要查找的文本' }, replaceText: { type: 'string', description: '替换为的文本' }, matchCase: { type: 'boolean', description: '是否区分大小写' }, }, required: ['filePath', 'searchText', 'replaceText'], type: 'object', }, },