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報告
- taskGuidanceRead - 讀取AI任務指導文件
- taskGuidanceWrite - 寫入AI任務指導文件
- taskStart - 開始一個任務
- taskComplete - 完成一個任務
檔案操作工具詳細說明
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"
});
註意事項
-
codeFileRead、codeLineInsert和codeLineDelete工具主要用於程式碼編輯，而新的檔案工具（fileWrite、fileRead等）更為通用，可用於任何類型的文本檔案。 -
使用
edit_file、insert_to_file和delete_from_file工具時，建議先啟用dryRun模式來預覽變更，確保操作不會造成意外的修改。 -
檔案路徑可以是相對路徑或絕對路徑。
-
進行批次操作時，建議使用
edit_file工具，可以在一次調用中進行多個編輯操作。