maic-server-fs-mcp 1.0.3 → 1.0.4

package/README.md

@@ -16,6 +16,41 @@
 | `executeCommand` | 在终端中运行命令（同步执行，最长 30 秒超时） | `command` (string) |
 | `dispatchTask` | 派发特定任务给下属专家（`CODER` 或 `TESTER`） | `worker` ('CODER' \| 'TESTER'), `taskInstruction` (string) |
 | `humanReview` | 人工审核插桩，用于人工确认 | `message` (string) |
+| `buildCodebaseIndex` | 扫描并为代码库构建本地向量索引（支持 JS/TS/JSX/TSX） | `dirPath` (string, 默认 `.`) |
+| `searchCodebase` | 语义化检索整个代码库，寻找匹配的代码片段 | `query` (string), `topK` (number, 默认 `3`) |
+
+---
+
+## 🧠 本地代码 RAG 功能说明
+
+为了使用 `buildCodebaseIndex` 和 `searchCodebase`（基于 `text-embedding-004` 模型），您需要在使用前配置 `GEMINI_API_KEY` 环境变量：
+
+* **命令行启动时设置**：
+  ```bash
+  export GEMINI_API_KEY="your-gemini-api-key"
+  npx -y --package maic-server-fs-mcp mcp-server-fs
+  ```
+* **Cursor 编辑器配置**：
+  在 Cursor 设置 MCP 时，您也可以在 Shell 配置文件（如 `~/.zshrc` 或 `~/.bashrc`）中全局导出 `GEMINI_API_KEY`，这样 Cursor 启动的进程可以读取到该变量。
+* **Claude Desktop 配置文件配置 (`claude_desktop_config.json`)**：
+  ```json
+  "maic-local-filesystem-mcp": {
+    "command": "npx",
+    "args": [
+      "-y",
+      "--package",
+      "maic-server-fs-mcp",
+      "mcp-server-fs"
+    ],
+    "env": {
+      "GEMINI_API_KEY": "your-gemini-api-key"
+    }
+  }
+  ```
+
+### 工作机制：
+1. **构建索引**：调用 `buildCodebaseIndex` 时，系统将扫描目录内的所有代码文件并按最长 40 行的窗口进行滑动切片，再通过 Gemini Embeddings API 向量化并保存在项目根目录的 `.rag_cache.json` 中。
+2. **语义化检索**：调用 `searchCodebase` 时，系统向量化您的查询，计算其与本地缓存中所有代码片段的余弦相似度（Cosine Similarity），并返回相似度最高的 `topK` 个真实代码片段。
 
 ---
 

package/dist/const/index.d.ts

@@ -0,0 +1,11 @@
+export declare const enum toolsName {
+    writeFile = "writeFile",
+    readDirectory = "readDirectory",
+    readFile = "readFile",
+    executeCommand = "executeCommand",
+    dispatchTask = "dispatchTask",
+    humanReview = "humanReview",
+    searchCodebase = "searchCodebase",
+    buildCodebaseIndex = "buildCodebaseIndex"
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/const/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../const/index.ts"],"names":[],"mappings":"AAAA,0BAAkB,SAAS;IACvB,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,QAAQ,aAAa;IACrB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;CAC5C"}

package/dist/const/index.js

@@ -0,0 +1,12 @@
+export var toolsName;
+(function (toolsName) {
+    toolsName["writeFile"] = "writeFile";
+    toolsName["readDirectory"] = "readDirectory";
+    toolsName["readFile"] = "readFile";
+    toolsName["executeCommand"] = "executeCommand";
+    toolsName["dispatchTask"] = "dispatchTask";
+    toolsName["humanReview"] = "humanReview";
+    toolsName["searchCodebase"] = "searchCodebase";
+    toolsName["buildCodebaseIndex"] = "buildCodebaseIndex";
+})(toolsName || (toolsName = {}));
+//# sourceMappingURL=index.js.map

package/dist/const/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../const/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAkB,SASjB;AATD,WAAkB,SAAS;IACvB,oCAAuB,CAAA;IACvB,4CAA+B,CAAA;IAC/B,kCAAqB,CAAA;IACrB,8CAAiC,CAAA;IACjC,0CAA6B,CAAA;IAC7B,wCAA2B,CAAA;IAC3B,8CAAiC,CAAA;IACjC,sDAAyC,CAAA;AAC7C,CAAC,EATiB,SAAS,KAAT,SAAS,QAS1B"}

package/dist/mcp-declaration/index.d.ts

@@ -0,0 +1,120 @@
+import { toolsName } from "../const/index.js";
+export declare const readFileDeclaration: {
+    name: toolsName;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            filePath: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const writeFileDeclaration: {
+    name: toolsName;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            filePath: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const readDirectoryDeclaration: {
+    name: toolsName;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            filePath: {
+                type: string;
+                description: string;
+                default: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const execCommandDeclaration: {
+    name: toolsName;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            command: {
+                type: string;
+                description: string;
+            };
+            timeoutMs: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const dispatchTaskDeclaration: {
+    name: toolsName;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            worker: {
+                type: string;
+                description: string;
+            };
+            taskInstruction: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const searchCodebaseDeclaration: {
+    name: toolsName;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            topK: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const buildCodebaseIndexDeclaration: {
+    name: toolsName;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            dirPath: {
+                type: string;
+                description: string;
+                default: string;
+            };
+        };
+        required: never[];
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-declaration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../mcp-declaration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAc/B,CAAA;AACD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;CAWhC,CAAA;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;CAepC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;CAYlC,CAAA;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;CAiBnC,CAAA;AAGD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;CAWrC,CAAC;AAGF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;CAczC,CAAC"}

package/dist/mcp-declaration/index.js

@@ -0,0 +1,102 @@
+import { toolsName } from "../const/index.js";
+export const readFileDeclaration = {
+    name: toolsName.readFile,
+    description: "读取指定路径的本地文件内容，允许 AI 查看文件代码或文本。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            filePath: {
+                type: "string",
+                description: "相对或绝对路径，例如 'package.json' 或 'src/index.js'",
+            },
+        },
+        required: ["filePath"],
+    },
+};
+export const writeFileDeclaration = {
+    name: toolsName.writeFile,
+    description: "向指定路径写入或覆盖文件内容，常用于生成/修改代码,允许 AI 修改文件代码或文本。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            filePath: { type: "STRING", description: "目标文件路径,相对或绝对路径，例如 'package.json' 或 'src/index.js'" },
+            content: { type: "STRING", description: "要写入文件的内容" },
+        },
+        required: ["filePath", "content"],
+    },
+};
+export const readDirectoryDeclaration = {
+    name: toolsName.readDirectory,
+    description: "列出指定目录下的所有文件和文件夹名称（已自动忽略 node_modules 等大文件夹）。当你不确定项目结构、找不到某个文件在哪里时，必须先调用此工具,辅助 AI 了解项目结构。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            filePath: {
+                type: "STRING",
+                description: "要扫描的目录路径,支持相对路径，绝对路径，（默认当前项目根）",
+                default: ".",
+            },
+        },
+        required: ["filePath"],
+    },
+};
+export const execCommandDeclaration = {
+    name: toolsName.executeCommand,
+    description: "在本地终端安全运行 shell 命令（如 npm test, git status, npm run build）。当修改代码后需要验证是否报错，或者需要安装依赖、运行构建时使用此工具。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            command: { type: "STRING", description: "要执行的 Shell 命令" },
+            timeoutMs: { type: "STRING", description: "命令超时时间（毫秒）", default: 60000 },
+        },
+        required: ["command"],
+    },
+};
+export const dispatchTaskDeclaration = {
+    name: toolsName.dispatchTask,
+    description: "当需要安排下属专家执行具体工作时调用此工具。每次只能派发一个任务，等下属汇报结果后，再派发下一个。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            worker: {
+                type: "STRING",
+                description: "接收任务的专家。'CODER' 负责读写代码文件；'TESTER' 负责运行终端编译或测试命令。",
+            },
+            taskInstruction: {
+                type: "STRING",
+                description: "具体要这个专家执行的详细指令。例如：'帮我查看 src/index.ts 的内容并修复其中的类型 Bug'。",
+            },
+        },
+        required: ["worker", "taskInstruction"],
+    },
+};
+// 定义 searchCodebase 的工具格式
+export const searchCodebaseDeclaration = {
+    name: toolsName.searchCodebase,
+    description: "语义化检索整个本地代码库。当不知道某段功能、组件、路由在哪里时，调用此工具通过关键词或功能描述找出最相关的真实代码片段。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "搜索词或代码功能描述，例如 'JWT 鉴权拦截器' 或 'Button 组件'" },
+            topK: { type: "integer", description: "返回的最相关的代码片段数量，默认为 3", default: 3 }
+        },
+        required: ["query"]
+    }
+};
+// 定义 buildCodebaseIndex 的工具格式
+export const buildCodebaseIndexDeclaration = {
+    name: toolsName.buildCodebaseIndex,
+    description: "扫描整个本地代码库（js/ts/jsx/tsx文件），调用 Gemini Embedding API 构建/重构本地向量索引。当项目代码发生重大变化后，或者首次使用 searchCodebase 前，必须调用此工具构建索引。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            dirPath: {
+                type: "string",
+                description: "要扫描和索引的根目录路径，支持相对路径，默认当前项目根目录 '.'",
+                default: "."
+            }
+        },
+        required: []
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/mcp-declaration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../mcp-declaration/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp-tool/LocalCodeRagTool.d.ts

@@ -0,0 +1,54 @@
+import { GoogleGenAI } from "@google/genai";
+export declare class LocalCodeRagService {
+    private ai;
+    private vectorStore;
+    private cachePath;
+    constructor(ai: GoogleGenAI);
+    private chunkCode;
+    buildIndex(dirPath: string): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    private loadIndex;
+    search({ query, topK }: {
+        query: string;
+        topK?: number | undefined;
+    }): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+}
+export declare const searchCodebaseTool: ({ query, topK }: {
+    query: string;
+    topK?: number;
+}) => Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const buildCodebaseIndexTool: ({ dirPath }: {
+    dirPath?: string;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=LocalCodeRagTool.d.ts.map

package/dist/mcp-tool/LocalCodeRagTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalCodeRagTool.d.ts","sourceRoot":"","sources":["../../mcp-tool/LocalCodeRagTool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAiB5C,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,SAAS,CAAkD;gBAEvD,EAAE,EAAE,WAAW;IAM3B,OAAO,CAAC,SAAS;IAiBJ,UAAU,CAAC,OAAO,EAAE,MAAM;;;;;;IA2EvC,OAAO,CAAC,SAAS;IAaJ,MAAM,CAAC,EAAE,KAAK,EAAE,IAAQ,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAmDtJ;AAgBD,eAAO,MAAM,kBAAkB,GAAU,iBAAiB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;aAnEqB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;;;;;;;EA+EnJ,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAU,aAAmB;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;EAanF,CAAC"}

package/dist/mcp-tool/LocalCodeRagTool.js

@@ -0,0 +1,214 @@
+// RAG 检索增强生成
+import * as fs from "fs";
+import * as path from "path";
+import { GoogleGenAI } from "@google/genai";
+// 简单实现一个余弦相似度计算
+function cosineSimilarity(vecA, vecB) {
+    const dotProduct = vecA.reduce((sum, a, i) => sum + a * (vecB[i] ?? 0), 0);
+    const normA = Math.sqrt(vecA.reduce((sum, a) => sum + a * a, 0));
+    const normB = Math.sqrt(vecB.reduce((sum, b) => sum + b * b, 0));
+    if (normA === 0 || normB === 0)
+        return 0;
+    return dotProduct / (normA * normB);
+}
+export class LocalCodeRagService {
+    ai;
+    vectorStore = [];
+    cachePath = path.resolve(process.cwd(), ".rag_cache.json");
+    constructor(ai) {
+        this.ai = ai;
+        this.loadIndex();
+    }
+    // 1. 简单的代码切块逻辑（按行数或者固定字符数切块，保持上下文）
+    chunkCode(filePath, content) {
+        const lines = content.split("\n");
+        const chunks = [];
+        const chunkSize = 40; // 每个代码块最多40行
+        const overlap = 10; // 允许10行重叠
+        for (let i = 0; i < lines.length; i += (chunkSize - overlap)) {
+            const chunkLines = lines.slice(i, i + chunkSize);
+            if (chunkLines.length > 5) { // 过滤掉太短的碎片
+                chunks.push(`// File: ${filePath}\n` + chunkLines.join("\n"));
+            }
+            if (i + chunkSize >= lines.length)
+                break;
+        }
+        return chunks;
+    }
+    // 2. 扫描并构建整个 codebase 的向量索引
+    async buildIndex(dirPath) {
+        console.error(`\n🔍 [RAG Indexing] 开始扫描目录并构建代码向量库: ${dirPath}...`);
+        const filesToScan = [];
+        const scanDir = (dir) => {
+            try {
+                const list = fs.readdirSync(dir);
+                list.forEach((file) => {
+                    try {
+                        const fullPath = path.join(dir, file);
+                        const stat = fs.statSync(fullPath);
+                        if (stat.isDirectory()) {
+                            if (!file.startsWith(".") &&
+                                file !== "node_modules" &&
+                                file !== "dist" &&
+                                file !== "build" &&
+                                file !== "out" &&
+                                file !== "coverage") {
+                                scanDir(fullPath);
+                            }
+                        }
+                        else if (/\.(js|ts|tsx|jsx)$/.test(file)) {
+                            filesToScan.push(fullPath);
+                        }
+                    }
+                    catch (e) {
+                        console.error(`⚠️ [RAG Indexing] 读取文件或目录属性失败: ${file}, 错误: ${e instanceof Error ? e.message : e}`);
+                    }
+                });
+            }
+            catch (e) {
+                console.error(`⚠️ [RAG Indexing] 读取目录失败: ${dir}, 错误: ${e instanceof Error ? e.message : e}`);
+            }
+        };
+        scanDir(dirPath);
+        const newStore = [];
+        for (const filePath of filesToScan) {
+            try {
+                const content = fs.readFileSync(filePath, "utf-8");
+                const chunks = this.chunkCode(path.relative(process.cwd(), filePath), content);
+                for (const chunk of chunks) {
+                    try {
+                        // 调用 Gemini 官方推荐的 Embedding 模型
+                        const response = await this.ai.models.embedContent({
+                            model: "text-embedding-004",
+                            contents: chunk,
+                        });
+                        const embedding = response.embeddings?.[0]?.values;
+                        if (embedding) {
+                            newStore.push({ filePath, content: chunk, embedding });
+                        }
+                    }
+                    catch (chunkError) {
+                        console.error(`⚠️ [RAG Indexing] 向量化代码块失败 (文件: ${filePath}):`, chunkError.message || chunkError);
+                    }
+                }
+            }
+            catch (fileError) {
+                console.error(`⚠️ [RAG Indexing] 读取文件内容失败 ${filePath}:`, fileError.message || fileError);
+            }
+        }
+        this.vectorStore = newStore;
+        fs.writeFileSync(this.cachePath, JSON.stringify(this.vectorStore, null, 2), "utf-8");
+        console.error(`✨ [RAG Indexing] 向量库构建完毕！共切分并向量化 ${this.vectorStore.length} 个代码块。`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ 向量库构建完毕！共扫描并向量化 ${this.vectorStore.length} 个代码块。缓存已保存至: ${this.cachePath}`
+                }
+            ]
+        };
+    }
+    loadIndex() {
+        try {
+            if (fs.existsSync(this.cachePath)) {
+                this.vectorStore = JSON.parse(fs.readFileSync(this.cachePath, "utf-8"));
+                console.error(`📊 [RAG] 成功从本地缓存加载了 ${this.vectorStore.length} 条代码向量。`);
+            }
+        }
+        catch (error) {
+            console.error(`⚠️ [RAG] 加载本地缓存向量索引失败，初始化为空向量库:`, error.message || error);
+            this.vectorStore = [];
+        }
+    }
+    // 3. 向量检索核心
+    async search({ query, topK = 3 }) {
+        if (this.vectorStore.length === 0) {
+            return {
+                content: [
+                    { type: "text", text: "⚠️ 警告：本地 RAG 向量库为空，请先运行 buildCodebaseIndex 工具构建索引。" }
+                ]
+            };
+        }
+        // 将用户的提问向量化
+        let queryEmbedding;
+        try {
+            const response = await this.ai.models.embedContent({
+                model: "text-embedding-004",
+                contents: query,
+            });
+            queryEmbedding = response.embeddings?.[0]?.values;
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `❌ 错误：生成查询向量失败。原因: ${error.message}` }
+                ]
+            };
+        }
+        if (!queryEmbedding) {
+            return {
+                content: [
+                    { type: "text", text: "❌ 错误：未能获取到有效的查询向量。" }
+                ]
+            };
+        }
+        // 计算相似度并排序
+        const results = this.vectorStore
+            .map((chunk) => ({
+            content: chunk.content,
+            similarity: cosineSimilarity(queryEmbedding, chunk.embedding),
+        }))
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, topK);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: results.map((r) => `[相似度: ${r.similarity.toFixed(4)}]\n${r.content}`).join("\n\n---\n\n"),
+                }
+            ]
+        };
+    }
+}
+let serviceInstance = null;
+function getRagService() {
+    if (!serviceInstance) {
+        const apiKey = process.env.GEMINI_API_KEY;
+        if (!apiKey) {
+            throw new Error("未检测到环境变量 GEMINI_API_KEY，无法使用 RAG 搜索/索引功能。请在启动前设置此环境变量。");
+        }
+        const ai = new GoogleGenAI({ apiKey });
+        serviceInstance = new LocalCodeRagService(ai);
+    }
+    return serviceInstance;
+}
+export const searchCodebaseTool = async ({ query, topK }) => {
+    try {
+        const service = getRagService();
+        return await service.search({ query, ...(topK !== undefined ? { topK } : {}) });
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: "text", text: `❌ 搜索代码库出错: ${error.message}` }
+            ],
+            isError: true
+        };
+    }
+};
+export const buildCodebaseIndexTool = async ({ dirPath = "." }) => {
+    try {
+        const service = getRagService();
+        const resolvedPath = path.resolve(process.cwd(), dirPath);
+        return await service.buildIndex(resolvedPath);
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: "text", text: `❌ 构建向量库出错: ${error.message}` }
+            ],
+            isError: true
+        };
+    }
+};
+//# sourceMappingURL=LocalCodeRagTool.js.map

package/dist/mcp-tool/LocalCodeRagTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalCodeRagTool.js","sourceRoot":"","sources":["../../mcp-tool/LocalCodeRagTool.ts"],"names":[],"mappings":"AAAA,aAAa;AAEb,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,gBAAgB;AAChB,SAAS,gBAAgB,CAAC,IAAc,EAAE,IAAc;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,UAAU,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;AACxC,CAAC;AAQD,MAAM,OAAO,mBAAmB;IACpB,EAAE,CAAc;IAChB,WAAW,GAAgB,EAAE,CAAC;IAC9B,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAEnE,YAAY,EAAe;QACvB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,mCAAmC;IAC3B,SAAS,CAAC,QAAgB,EAAE,OAAe;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC,aAAa;QACnC,MAAM,OAAO,GAAG,EAAE,CAAC,CAAG,UAAU;QAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;YAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;YACjD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW;gBACpC,MAAM,CAAC,IAAI,CAAC,YAAY,QAAQ,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,CAAC,GAAG,SAAS,IAAI,KAAK,CAAC,MAAM;gBAAE,MAAM;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,4BAA4B;IACrB,KAAK,CAAC,UAAU,CAAC,OAAe;QACnC,OAAO,CAAC,KAAK,CAAC,uCAAuC,OAAO,KAAK,CAAC,CAAC;QACnE,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;oBAClB,IAAI,CAAC;wBACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;wBACtC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;4BACrB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gCACrB,IAAI,KAAK,cAAc;gCACvB,IAAI,KAAK,MAAM;gCACf,IAAI,KAAK,OAAO;gCAChB,IAAI,KAAK,KAAK;gCACd,IAAI,KAAK,UAAU,EACrB,CAAC;gCACC,OAAO,CAAC,QAAQ,CAAC,CAAC;4BACtB,CAAC;wBACL,CAAC;6BAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;4BACzC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBAC/B,CAAC;oBACL,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACT,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,SAAS,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACvG,CAAC;gBACL,CAAC,CAAC,CAAC;YACP,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CAAC,6BAA6B,GAAG,SAAS,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjG,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,CAAC;QACjB,MAAM,QAAQ,GAAgB,EAAE,CAAC;QAEjC,KAAK,MAAM,QAAQ,IAAI,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;gBAE/E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACzB,IAAI,CAAC;wBACD,+BAA+B;wBAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC;4BAC/C,KAAK,EAAE,oBAAoB;4BAC3B,QAAQ,EAAE,KAAK;yBAClB,CAAC,CAAC;wBAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;wBACnD,IAAI,SAAS,EAAE,CAAC;4BACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;wBAC3D,CAAC;oBACL,CAAC;oBAAC,OAAO,UAAe,EAAE,CAAC;wBACvB,OAAO,CAAC,KAAK,CAAC,mCAAmC,QAAQ,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC;oBACrG,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,OAAO,SAAc,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,8BAA8B,QAAQ,GAAG,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;YAC7F,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;QAC5B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrF,OAAO,CAAC,KAAK,CAAC,oCAAoC,IAAI,CAAC,WAAW,CAAC,MAAM,QAAQ,CAAC,CAAC;QACnF,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qBAAqB,IAAI,CAAC,WAAW,CAAC,MAAM,iBAAiB,IAAI,CAAC,SAAS,EAAE;iBACtF;aACJ;SACJ,CAAC;IACN,CAAC;IAEO,SAAS;QACb,IAAI,CAAC;YACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;gBACxE,OAAO,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,WAAW,CAAC,MAAM,SAAS,CAAC,CAAC;YAC3E,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;YACzE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,YAAY;IACL,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,EAAgD;QACjF,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;gBACH,OAAO,EAAE;oBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oDAAoD,EAAE;iBAC/E;aACJ,CAAC;QACN,CAAC;QAED,YAAY;QACZ,IAAI,cAAoC,CAAC;QACzC,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC;gBAC/C,KAAK,EAAE,oBAAoB;gBAC3B,QAAQ,EAAE,KAAK;aAClB,CAAC,CAAC;YACH,cAAc,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QACtD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,OAAO,EAAE;oBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,KAAK,CAAC,OAAO,EAAE,EAAE;iBAC/D;aACJ,CAAC;QACN,CAAC;QAED,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,OAAO;gBACH,OAAO,EAAE;oBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE;iBAC/C;aACJ,CAAC;QACN,CAAC;QAED,WAAW;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW;aAC3B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACb,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,gBAAgB,CAAC,cAAe,EAAE,KAAK,CAAC,SAAS,CAAC;SACjE,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAEpB,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;iBAClG;aACJ;SACJ,CAAC;IACN,CAAC;CACJ;AAED,IAAI,eAAe,GAA+B,IAAI,CAAC;AAEvD,SAAS,aAAa;IAClB,IAAI,CAAC,eAAe,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,eAAe,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAoC,EAAE,EAAE;IAC1F,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,CAAC,OAAO,EAAE,EAAE;aACxD;YACD,OAAO,EAAE,IAAI;SAChB,CAAC;IACN,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,EAAE,OAAO,GAAG,GAAG,EAAwB,EAAE,EAAE;IACpF,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,CAAC,OAAO,EAAE,EAAE;aACxD;YACD,OAAO,EAAE,IAAI;SAChB,CAAC;IACN,CAAC;AACL,CAAC,CAAC"}

package/dist/mcp-tool/index.d.ts

@@ -0,0 +1,78 @@
+import { toolsName } from "../const/index.js";
+export declare const humanReviewTool: {
+    name: toolsName;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            message: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const readfileTool: ({ filePath }: {
+    filePath: string;
+}) => {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: never;
+};
+export declare const writefileTool: ({ filePath, content, }: {
+    filePath: string;
+    content: string;
+}) => {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: never;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare const readDirectoryTool: ({ dirPath }: {
+    dirPath?: string;
+}) => string | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: never;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare const execCommandTool: ({ command }: {
+    command: string;
+}) => {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: never;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare const toolMap: Map<string, Function>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-tool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../mcp-tool/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAa3B,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,cAAc;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;CAuB9D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,wBAG3B;IACC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;CAyBA,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,aAAmB;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;CAmCxE,CAAC;AAGF,eAAO,MAAM,eAAe,GAAI,aAAa;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;CAsB/D,CAAC;AAEF,eAAO,MAAM,OAAO,uBAOlB,CAAA"}

package/dist/mcp-tool/index.js

@@ -0,0 +1,139 @@
+import * as fs from "fs";
+import * as path from "path";
+import { execSync } from "child_process";
+import { toolsName } from "../const/index.js";
+import { searchCodebaseTool, buildCodebaseIndexTool } from "./LocalCodeRagTool.js";
+// 定义人类审阅工具（无实际执行逻辑，仅用于触发对话）
+export const humanReviewTool = {
+    name: toolsName.humanReview,
+    description: "需要人工审核或确认时调用。",
+    parameters: {
+        type: "object",
+        properties: {
+            message: {
+                type: "string",
+                description: "给人类的留言或请求确认的内容。",
+            }
+        },
+        required: ["message"]
+    }
+};
+export const readfileTool = ({ filePath }) => {
+    try {
+        const fullPath = path.resolve(process.cwd(), filePath);
+        if (!fs.existsSync(fullPath)) {
+            return {
+                content: [
+                    { type: "text", text: `Error: File ${fullPath} does not exist.` },
+                ],
+                isError: true,
+            };
+        }
+        const fileContent = fs.readFileSync(fullPath, "utf-8");
+        return {
+            content: [{ type: "text", text: fileContent }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: "text", text: `Error reading file: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+};
+export const writefileTool = ({ filePath, content, }) => {
+    try {
+        const fullPath = path.resolve(process.cwd(), filePath);
+        // 确保目标文件的父级文件夹存在（可选，防错）
+        const dir = path.dirname(fullPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(fullPath, content, "utf-8");
+        return {
+            content: [
+                { type: 'text', text: `✅ Successfully wrote ${content.length} characters to: ${fullPath}` }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ Error writing file: ${error.message}`
+                }
+            ],
+            isError: true,
+        };
+    }
+};
+export const readDirectoryTool = ({ dirPath = "." }) => {
+    try {
+        const fullPath = path.resolve(process.cwd(), dirPath);
+        if (!fs.existsSync(fullPath)) {
+            return `❌ Error: Directory ${fullPath} does not exist.`;
+        }
+        // 读取当前目录下的所有文件和文件夹
+        const files = fs.readdirSync(fullPath, { withFileTypes: true });
+        // 过滤掉不必要的庞大文件夹（如 node_modules, .git），否则数据太多会干扰 AI
+        const ignoredDirs = ["node_modules", ".git", ".next", "dist"];
+        const resultList = files
+            .filter((file) => !ignoredDirs.includes(file.name))
+            .map((file) => {
+            return `${file.isDirectory() ? "📁" : "📄"} ${file.name}`;
+        });
+        return {
+            content: [
+                { type: 'text', text: `📁 Current Directory: ${dirPath}\n` + resultList.join("\n") }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ Error reading directory: ${error.message}`
+                }
+            ],
+            isError: true,
+        };
+    }
+};
+// 修复工具函数：执行命令行指令
+export const execCommandTool = ({ command }) => {
+    try {
+        console.error(`\n⚠️ [⚠️安全警告] Agent 正在本地终端执行命令: ${command}`);
+        // 在当前目录下同步执行命令，并捕获标准输出
+        const output = execSync(command, { encoding: "utf-8", timeout: 30000 });
+        return {
+            content: [
+                { type: 'text', text: `ℹ️ Command Executed Successfully. Output:\n${output}` }
+            ],
+        };
+    }
+    catch (error) {
+        // 如果命令报错（比如编译挂了），把报错信息完整吐给 AI，AI 会根据报错自己修 Bug！
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ Command Failed with Error:\n${error.stdout || error.message}`
+                }
+            ],
+            isError: true,
+        };
+    }
+};
+export const toolMap = new Map([
+    [toolsName.readFile, readfileTool],
+    [toolsName.writeFile, writefileTool],
+    [toolsName.readDirectory, readDirectoryTool],
+    [toolsName.executeCommand, execCommandTool],
+    [toolsName.searchCodebase, searchCodebaseTool],
+    [toolsName.buildCodebaseIndex, buildCodebaseIndexTool]
+]);
+//# sourceMappingURL=index.js.map

package/dist/mcp-tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../mcp-tool/index.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -1,78 +1,3 @@
 #!/usr/bin/env node
-import { toolsName } from "./const.js";
-export declare const humanReviewTool: {
-    name: toolsName;
-    description: string;
-    parameters: {
-        type: string;
-        properties: {
-            message: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare const readfileTool: ({ filePath }: {
-    filePath: string;
-}) => {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: never;
-};
-export declare const writefileTool: ({ filePath, content, }: {
-    filePath: string;
-    content: string;
-}) => {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: never;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-};
-export declare const readDirectoryTool: ({ dirPath }: {
-    dirPath?: string;
-}) => string | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: never;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-};
-export declare const execCommandTool: ({ command }: {
-    command: string;
-}) => {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: never;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-};
+export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":";AAYA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA0GvC,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAa3B,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,cAAc;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;CAuB9D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,wBAG3B;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;;;;;;;;;;;;CAyBA,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,aAAmB;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;CAmCxE,CAAC;AAGF,eAAO,MAAM,eAAe,GAAI,aAAa;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;CAsB/D,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -2,10 +2,8 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import * as fs from "fs";
-import * as path from "path";
-import { execSync } from "child_process";
-import { toolsName } from "./const.js";
+import { toolMap } from "./mcp-tool/index.js";
+import { readFileDeclaration, writeFileDeclaration, readDirectoryDeclaration, execCommandDeclaration, dispatchTaskDeclaration, searchCodebaseDeclaration, buildCodebaseIndexDeclaration } from "./mcp-declaration/index.js";
 // 1. 初始化 MCP 服务端实例，声明你的服务名称和版本
 const server = new Server({
     name: "maic-local-filesystem-mcp",
@@ -19,218 +17,16 @@ const server = new Server({
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
         tools: [
-            {
-                name: toolsName.readFile,
-                description: "读取指定路径的本地文件内容，允许 AI 查看文件代码或文本。",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        filePath: {
-                            type: "string",
-                            description: "相对或绝对路径，例如 'package.json' 或 'src/index.js'",
-                        },
-                    },
-                    required: ["filePath"],
-                },
-            },
-            {
-                name: toolsName.writeFile,
-                description: "写入指定路径的本地文件内容，允许 AI 修改文件代码或文本。",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        filePath: {
-                            type: "STRING",
-                            description: "相对或绝对路径，例如 'package.json' 或 'src/index.js'",
-                        },
-                        content: {
-                            type: "STRING",
-                            description: "要写入文件的内容",
-                        },
-                    },
-                    required: ["filePath", "content"],
-                },
-            },
-            {
-                name: toolsName.readDirectory,
-                description: "列出指定目录下的所有文件和文件夹名称（已自动忽略 node_modules 等大文件夹）。当你不确定项目结构、找不到某个文件在哪里时，必须先调用此工具。",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        filePath: {
-                            type: "STRING",
-                            description: "要查询的目录路径，默认是当前根目录 '.'，或者例如 'src/components'",
-                        },
-                    },
-                    required: ['filePath']
-                }
-            },
-            {
-                name: toolsName.executeCommand,
-                description: "在本地终端安全运行 shell 命令（如 npm test, git status, npm run build）。当修改代码后需要验证是否报错，或者需要安装依赖、运行构建时使用此工具。",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        command: {
-                            type: "STRING",
-                            description: "需要执行的完整命令，例如 'npm run build' 或 'node test.js'",
-                        },
-                    },
-                    required: ["command"],
-                }
-            },
-            {
-                name: toolsName.dispatchTask,
-                description: "当需要安排下属专家执行具体工作时调用此工具。每次只能派发一个任务，等下属汇报结果后，再派发下一个。",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        worker: {
-                            type: "STRING",
-                            description: "接收任务的专家。'CODER' 负责读写代码文件；'TESTER' 负责运行终端编译或测试命令。",
-                        },
-                        taskInstruction: {
-                            type: "STRING",
-                            description: "具体要这个专家执行的详细指令。例如：'帮我查看 src/index.ts 的内容并修复其中的类型 Bug'。",
-                        },
-                    },
-                    required: ["worker", "taskInstruction"]
-                }
-            }
+            readFileDeclaration,
+            writeFileDeclaration,
+            readDirectoryDeclaration,
+            execCommandDeclaration,
+            dispatchTaskDeclaration,
+            searchCodebaseDeclaration,
+            buildCodebaseIndexDeclaration
         ],
     };
 });
-// 定义人类审阅工具（无实际执行逻辑，仅用于触发对话）
-export const humanReviewTool = {
-    name: toolsName.humanReview,
-    description: "需要人工审核或确认时调用。",
-    parameters: {
-        type: "object",
-        properties: {
-            message: {
-                type: "string",
-                description: "给人类的留言或请求确认的内容。",
-            }
-        },
-        required: ["message"]
-    }
-};
-export const readfileTool = ({ filePath }) => {
-    try {
-        const fullPath = path.resolve(process.cwd(), filePath);
-        if (!fs.existsSync(fullPath)) {
-            return {
-                content: [
-                    { type: "text", text: `Error: File ${fullPath} does not exist.` },
-                ],
-                isError: true,
-            };
-        }
-        const fileContent = fs.readFileSync(fullPath, "utf-8");
-        return {
-            content: [{ type: "text", text: fileContent }],
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                { type: "text", text: `Error reading file: ${error.message}` },
-            ],
-            isError: true,
-        };
-    }
-};
-export const writefileTool = ({ filePath, content, }) => {
-    try {
-        const fullPath = path.resolve(process.cwd(), filePath);
-        // 确保目标文件的父级文件夹存在（可选，防错）
-        const dir = path.dirname(fullPath);
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-        }
-        fs.writeFileSync(fullPath, content, "utf-8");
-        return {
-            content: [
-                { type: 'text', text: `✅ Successfully wrote ${content.length} characters to: ${fullPath}` }
-            ],
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `❌ Error writing file: ${error.message}`
-                }
-            ],
-            isError: true,
-        };
-    }
-};
-export const readDirectoryTool = ({ dirPath = "." }) => {
-    try {
-        const fullPath = path.resolve(process.cwd(), dirPath);
-        if (!fs.existsSync(fullPath)) {
-            return `❌ Error: Directory ${fullPath} does not exist.`;
-        }
-        // 读取当前目录下的所有文件和文件夹
-        const files = fs.readdirSync(fullPath, { withFileTypes: true });
-        // 过滤掉不必要的庞大文件夹（如 node_modules, .git），否则数据太多会干扰 AI
-        const ignoredDirs = ["node_modules", ".git", ".next", "dist"];
-        const resultList = files
-            .filter((file) => !ignoredDirs.includes(file.name))
-            .map((file) => {
-            return `${file.isDirectory() ? "📁" : "📄"} ${file.name}`;
-        });
-        return {
-            content: [
-                { type: 'text', text: `📁 Current Directory: ${dirPath}\n` + resultList.join("\n") }
-            ],
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `❌ Error reading directory: ${error.message}`
-                }
-            ],
-            isError: true,
-        };
-    }
-};
-// 修复工具函数：执行命令行指令
-export const execCommandTool = ({ command }) => {
-    try {
-        console.log(`\n⚠️ [⚠️安全警告] Agent 正在本地终端执行命令: ${command}`);
-        // 在当前目录下同步执行命令，并捕获标准输出
-        const output = execSync(command, { encoding: "utf-8", timeout: 30000 });
-        return {
-            content: [
-                { type: 'text', text: `ℹ️ Command Executed Successfully. Output:\n${output}` }
-            ],
-        };
-    }
-    catch (error) {
-        // 如果命令报错（比如编译挂了），把报错信息完整吐给 AI，AI 会根据报错自己修 Bug！
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `❌ Command Failed with Error:\n${error.stdout || error.message}`
-                }
-            ],
-            isError: true,
-        };
-    }
-};
-const toolMap = new Map([
-    [toolsName.readFile, readfileTool],
-    [toolsName.writeFile, writefileTool],
-    [toolsName.readDirectory, readDirectoryTool],
-    [toolsName.executeCommand, execCommandTool],
-]);
 // 3. 注册工具执行核心：当 AI 真正要调用工具时，执行你原本的 Node.js 物理逻辑
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,4BAA4B,CAAA;AAEnC,+BAA+B;AAC/B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE,EAAE,iCAAiC;KAC7C;CACF,CACF,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL,mBAAmB;YACnB,oBAAoB;YACpB,wBAAwB;YACxB,sBAAsB;YACtB,uBAAuB;YACvB,yBAAyB;YACzB,6BAA6B;SAC9B;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAIH,gDAAgD;AAChD,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,mCAAmC;AACnC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC/C,iFAAiF;AACnF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "maic-server-fs-mcp",
-    "version": "1.0.3",
+    "version": "1.0.4",
     "description": "一个用于读取本地文件的自定义标准 MCP 服务端",
     "main": "./dist/server.js",
     "bin": {
@@ -33,6 +33,7 @@
     "homepage": "https://github.com/maicFir/server-fs-mcp#readme",
     "type": "module",
     "dependencies": {
+        "@google/genai": "^2.9.0",
         "@modelcontextprotocol/sdk": "^1.29.0"
     },
     "devDependencies": {