{"id":29155275,"url":"https://github.com/GonTwVn/gonmcptool","last_synced_at":"2025-07-01T02:36:43.773Z","repository":{"id":284709022,"uuid":"955806472","full_name":"GonTwVn/GonMCPtool","owner":"GonTwVn","description":"Gon的MCP工具","archived":false,"fork":false,"pushed_at":"2025-04-29T20:34:32.000Z","size":112,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T13:13:02.603Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GonTwVn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-27T08:22:31.000Z","updated_at":"2025-04-29T20:34:36.000Z","dependencies_parsed_at":"2025-03-27T09:37:56.782Z","dependency_job_id":"77d2d5be-3ef1-4cfe-b72b-aa2b30430bff","html_url":"https://github.com/GonTwVn/GonMCPtool","commit_stats":null,"previous_names":["gontwvn/gonmcptool"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GonTwVn/GonMCPtool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GonTwVn%2FGonMCPtool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GonTwVn%2FGonMCPtool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GonTwVn%2FGonMCPtool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GonTwVn%2FGonMCPtool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GonTwVn","download_url":"https://codeload.github.com/GonTwVn/GonMCPtool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GonTwVn%2FGonMCPtool/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262884922,"owners_count":23379472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-01T02:34:43.177Z","updated_at":"2025-07-01T02:36:43.765Z","avatar_url":"https://github.com/GonTwVn.png","language":"TypeScript","funding_links":[],"categories":["Development Tools MCP Servers"],"sub_categories":[],"readme":"[![MseeP.ai Security Assessment Badge](https://mseep.net/mseep-audited.png)](https://mseep.ai/app/gontwvn-gonmcptool)\n\n# MCP 伺服器工具集\n\n[![smithery badge](https://smithery.ai/badge/@GonTwVn/GonMCPtool)](https://smithery.ai/server/@GonTwVn/GonMCPtool)\n\n這是一個基於 Model Context Protocol 的伺服器工具集，提供多種功能來輔助開發和維護工作。\n\n\u003ca href=\"https://glama.ai/mcp/servers/@GonTwVn/GonMCPtool\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@GonTwVn/GonMCPtool/badge\" alt=\"GonMCPtool MCP server\" /\u003e\n\u003c/a\u003e\n\n## 功能概覽\n\n### 基本工具\n- **add** - 簡單的加法計算工具\n- **npmBuild** - 執行 npm build 命令構建專案\n- **npmInstall** - 執行 npm install 命令安裝依賴\n\n### 檔案操作工具\n- **codeFileRead** - 讀取程式碼檔案並顯示行號\n- **codeLineInsert** - 在程式碼檔案指定行插入內容\n- **codeLineDelete** - 刪除程式碼檔案指定範圍的行\n- **fileWrite** - 檔案寫入功能，提供建立、編輯與寫入功能\n- **fileRead** - 讀取檔案內容，支援純文本和JSON格式\n- **edit_file** - 對檔案進行精確的編輯，可以替換特定文字內容\n- **insert_to_file** - 在檔案的特定位置插入新內容\n- **delete_from_file** - 從檔案中刪除特定內容\n\n### 搜尋工具\n- **find_files** - 在允許的目錄中找尋符合檔名模式的檔案\n- **search_code** - 在允許的目錄中搜尋包含特定文字的程式碼\n\n### 本地化工具\n- **localizationGetByKey** - 根據Key查詢特定翻譯項目\n- **localizationSearch** - 搜尋包含特定文字的翻譯項目\n- **localizationAdd** - 新增一個完整的翻譯項目\n- **localizationUpdate** - 更新現有翻譯項目的內容\n- **localizationDelete** - 刪除指定Key的翻譯項目\n- **localizationExportJson** - 將特定語言的翻譯導出為JSON格式\n- **localizationFindMissing** - 查找有Key值但缺少特定語言翻譯的項目\n- **localizationFindLongValues** - 查找超過特定字數的翻譯項目\n\n### 任務管理器工具\n- **taskCreate** - 創建新的任務，可以包含多個步驟\n- **taskGetAll** - 獲取所有任務列表\n- **taskGetById** - 根據ID獲取特定任務\n- **taskUpdate** - 更新現有任務信息\n- **taskDelete** - 刪除指定ID的任務\n- **taskStepUpdate** - 更新任務的特定步驟\n- **taskStepAdd** - 為任務添加新步驟\n- **taskStepDelete** - 刪除任務的特定步驟\n- **taskSearch** - 根據條件搜索任務\n- **taskAnalyze** - 獲取任務狀態分析報告\n- **taskSetAllSteps** - 設定某個任務所有步驟的完成狀態\n- **taskGenerateReport** - 生成任務進度Markdown報告\n- **taskGuidanceRead** - 讀取AI任務指導文件\n- **taskGuidanceWrite** - 寫入AI任務指導文件\n- **taskStart** - 開始一個任務\n- **taskComplete** - 完成一個任務\n\n\n## 檔案操作工具詳細說明\n\n### fileWrite\n提供檔案寫入功能，可以創建新檔案或修改現有檔案。\n\n```javascript\nfileWrite({\n  filePath: \"path/to/file.txt\",\n  content: \"This is the content\",\n  mode: \"write\", // 可選值: write, append, json\n  createDirs: true, // 可選，是否自動創建目錄\n  prettify: true // 可選，僅對json模式有效，是否美化JSON輸出\n})\n```\n\n### fileRead\n讀取檔案內容，支援純文本和JSON格式。\n\n```javascript\nfileRead({\n  filePath: \"path/to/file.txt\",\n  mode: \"text\", // 可選值: text, json\n  encoding: \"utf8\" // 可選，指定編碼方式\n})\n```\n\n### edit_file\n對檔案進行精確的編輯，可以替換特定文字內容。\n\n```javascript\nedit_file({\n  path: \"path/to/file.txt\",\n  edits: [\n    {\n      oldText: \"要替換的文字\",\n      newText: \"替換後的文字\"\n    }\n  ],\n  dryRun: false // 可選，預覽變更而不實際修改檔案\n})\n```\n\n### insert_to_file\n在檔案的特定位置插入新內容。\n\n```javascript\ninsert_to_file({\n  path: \"path/to/file.txt\",\n  position: 10, // 行號 (從1開始)，或標記文字\n  content: \"要插入的內容\",\n  dryRun: false // 可選，預覽變更而不實際修改檔案\n})\n```\n\n### delete_from_file\n從檔案中刪除特定內容。\n\n```javascript\ndelete_from_file({\n  path: \"path/to/file.txt\",\n  selector: \"要刪除的文字\", // 或 {startLine: 5, endLine: 10} 或 {start: \"開始標記\", end: \"結束標記\"}\n  dryRun: false // 可選，預覽變更而不實際修改檔案\n})\n```\n\n## 使用範例\n\n### 建立和編輯檔案\n\n```javascript\n// 創建一個新的 TypeScript 檔案\nfileWrite({\n  filePath: \"src/utils/helper.ts\",\n  content: `export function add(a: number, b: number): number {\n  return a + b;\n}`,\n  mode: \"write\"\n});\n\n// 讀取檔案內容\nfileRead({\n  filePath: \"src/utils/helper.ts\",\n  mode: \"text\"\n});\n\n// 編輯檔案中的特定文字\nedit_file({\n  path: \"src/utils/helper.ts\",\n  edits: [\n    {\n      oldText: \"export function add\",\n      newText: \"export function sum\"\n    }\n  ]\n});\n\n// 在檔案中插入新內容\ninsert_to_file({\n  path: \"src/utils/helper.ts\",\n  position: 1, // 在第一行插入\n  content: \"// Math utility functions\\n\"\n});\n\n// 刪除檔案中的特定內容\ndelete_from_file({\n  path: \"src/utils/helper.ts\",\n  selector: \"// Math utility functions\\n\"\n});\n```\n\n### 使用 JSON 模式\n\n```javascript\n// 創建 JSON 配置檔案\nfileWrite({\n  filePath: \"config.json\",\n  content: '{\"version\": \"1.0.0\", \"debug\": false}',\n  mode: \"json\",\n  prettify: true\n});\n\n// 讀取 JSON 檔案\nfileRead({\n  filePath: \"config.json\",\n  mode: \"json\"\n});\n```\n\n## 註意事項\n\n1. `codeFileRead`、`codeLineInsert` 和 `codeLineDelete` 工具主要用於程式碼編輯，而新的檔案工具（`fileWrite`、`fileRead` 等）更為通用，可用於任何類型的文本檔案。\n\n2. 使用 `edit_file`、`insert_to_file` 和 `delete_from_file` 工具時，建議先啟用 `dryRun` 模式來預覽變更，確保操作不會造成意外的修改。\n\n3. 檔案路徑可以是相對路徑或絕對路徑。\n\n4. 進行批次操作時，建議使用 `edit_file` 工具，可以在一次調用中進行多個編輯操作。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGonTwVn%2Fgonmcptool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGonTwVn%2Fgonmcptool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGonTwVn%2Fgonmcptool/lists"}