tca-mcp-server 1.2.0 → 1.3.2

package/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx lint-staged

package/.prettierrc

@@ -0,0 +1,4 @@
+printWidth: 100
+tabWidth: 4
+singleQuote: true
+trailingComma: 'es5'

package/dist/api/oplog.js

@@ -0,0 +1,58 @@
+import TcaClient from './client.js';
+const opPluginType = 2;
+// 操作类型枚举，目前只有scan_remote
+export var LogType;
+(function (LogType) {
+    LogType["ScanRemote"] = "scan_remote";
+    LogType["GetReport"] = "get_report";
+    LogType["GetIssue"] = "get_issues";
+    LogType["GetAiSug"] = "get_ai_sug";
+    LogType["GetJobStatus"] = "get_job_status";
+})(LogType || (LogType = {}));
+// 状态枚举， 1 成功，2 失败
+export var LogStatus;
+(function (LogStatus) {
+    LogStatus[LogStatus["Success"] = 1] = "Success";
+    LogStatus[LogStatus["Failed"] = 2] = "Failed";
+})(LogStatus || (LogStatus = {}));
+/**
+ * 记录MCP操作日志（带超时控制，不影响调用方）
+ * @param opType 操作类型
+ * @param startTime 开始时间
+ * @param endTime 结束时间（可选）
+ * @param status 操作状态（可选）
+ * @param resultMsg 结果信息（可选）
+ * @param opPluginData 插件操作数据（可选）
+ * @param timeout 超时时间，默认5000ms
+ */
+export function recordOpLog(opType, startTime, endTime, status, resultMsg, opPluginData, timeout = 5000) {
+    // IIFE，异步代码，不阻塞调用方
+    // 增加try catch，捕获异常但不抛出，仅输出错误，不影响主流程
+    if (TcaClient.getInstance().runInOA()) {
+        return;
+    }
+    (async () => {
+        try {
+            const clientInst = TcaClient.getInstance();
+            if (!clientInst.runInOA()) {
+                const { orgSid } = TcaClient.getcommonParams();
+                const path = `/server/main/api/orgs/${orgSid}/oplogs/pluginoprecords/`;
+                const logData = {
+                    op_action: opType,
+                    start_time: startTime,
+                    op_plugin_type: opPluginType,
+                    ...(endTime && { end_time: endTime }),
+                    ...(status && { status }),
+                    ...(resultMsg && { result_msg: resultMsg }),
+                    ...(opPluginData && { op_plugin_data: opPluginData }),
+                };
+                const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('日志记录超时')), timeout));
+                await Promise.race([clientInst.request(path, 'POST', logData), timeoutPromise]);
+            }
+        }
+        catch (error) {
+            // 仅在输出错误，但不影响调用方
+            console.error('记录操作日志失败:', error);
+        }
+    })();
+}

package/dist/stdio.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { registerTools } from "./tools/index.js";
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerTools } from './tools/index.js';
 // Create an MCP server
 const server = new McpServer({
-    name: "腾讯云代码分析(TCA)",
-    version: "1.0.0"
+    name: '腾讯云代码分析(TCA)',
+    version: '1.3.2',
 });
 // 从命令行获取参数，如果 --oa参数存在，则表示运行在OA环境，否则运行在SaaS环境
-const env = process.argv.includes("--oa") ? "oa" : "saas";
+const env = process.argv.includes('--oa') ? 'oa' : 'saas';
 process.env.TCA_ENV = env;
 registerTools(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.log("Server started");
+console.log('Server started');

package/dist/tools/issue.js

@@ -1,7 +1,9 @@
-import { z } from "zod";
-import TcaClient, { webUrlOA } from "../api/client.js";
-import { formatTextToolResult, formatToolError } from "../utils/resp.js";
-import { getIssueList } from "../api/issue.js";
+import { z } from 'zod';
+import TcaClient, { webUrlOA } from '../api/client.js';
+import { formatTextToolResult, formatToolError } from '../utils/resp.js';
+import { getIssueList } from '../api/issue.js';
+import { recordOpLog, LogType, LogStatus } from '../api/oplog.js';
+import { getNowCstDateTime } from '../utils/time.js';
 export default function registerIssueReport(server) {
     server.tool('tca_issue_list', `获取当前项目未解决的问题列表, 参数如下：
         -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
@@ -11,17 +13,27 @@ export default function registerIssueReport(server) {
         -limit: 限制数量
         `, {
         mcpConfigFile: z.string(),
-        state: z.string().default("0,1,2,3,4,5"),
-        severity: z.string().default("0,1,2"),
+        state: z.string().default('0,1,2,3,4,5'),
+        severity: z.string().default('0,1,2'),
         offset: z.number().default(0),
         limit: z.number().default(10),
     }, async ({ mcpConfigFile, state, severity, offset, limit }) => {
         await TcaClient.initConfig(mcpConfigFile);
+        const startTime = getNowCstDateTime();
         try {
             const res = await getIssueList(state, severity, offset, limit);
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.GetIssue, startTime, endTime, LogStatus.Success);
             return formatTextToolResult(JSON.stringify(res, null, 2), 'get issue list');
         }
         catch (error) {
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.GetIssue, startTime, endTime, LogStatus.Failed, String(error), {
+                state: state,
+                severity: severity,
+                offset: offset,
+                limit: limit,
+            });
             return formatToolError(error, 'get issue list error');
         }
     });
@@ -29,10 +41,11 @@ export default function registerIssueReport(server) {
         -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
         -jobId: 任务id, 启动分析任务后，从返回结果中获取`, {
         mcpConfigFile: z.string(),
-        jobId: z.string().describe("jobId"),
+        jobId: z.string().describe('jobId'),
     }, async ({ mcpConfigFile, jobId }) => {
         await TcaClient.initConfig(mcpConfigFile);
         const clientInst = TcaClient.getInstance();
+        const startTime = getNowCstDateTime();
         if (clientInst.runInOA()) {
             const paramsOA = TcaClient.getcommonOAParams();
             const path = `code-analysis/repos/${paramsOA.repoId}/projects/${paramsOA.projectId}/scan-history/${jobId}/result`;
@@ -42,7 +55,10 @@ export default function registerIssueReport(server) {
             const baseUrl = TcaClient.getInstance().baseUrl;
             const params = TcaClient.getcommonParams();
             const path = `t/${params.orgSid}/p/${params.teamName}/repos/${params.repoId}/projects/${params.projectId}/jobs/${jobId}/result`;
-            return formatTextToolResult(baseUrl + path, 'tca issue report link');
+            const endTime = getNowCstDateTime();
+            var reportUrl = baseUrl + path;
+            recordOpLog(LogType.GetReport, startTime, endTime, LogStatus.Success, reportUrl);
+            return formatTextToolResult(reportUrl, 'tca issue report link');
         }
     });
 }

package/dist/tools/job.js

@@ -1,20 +1,27 @@
-import { z } from "zod";
-import TcaClient from "../api/client.js";
-import { formatTextToolResult, formatToolError } from "../utils/resp.js";
-import { getJobDetail, getJobList } from "../api/job.js";
+import { z } from 'zod';
+import TcaClient from '../api/client.js';
+import { formatTextToolResult, formatToolError } from '../utils/resp.js';
+import { getJobDetail, getJobList } from '../api/job.js';
+import { recordOpLog, LogType, LogStatus } from '../api/oplog.js';
+import { getNowCstDateTime } from '../utils/time.js';
 export default function registerJob(server) {
     server.tool('job_detail', `获取任务详情, 参数如下：
         -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
         -jobId: 任务id`, {
         mcpConfigFile: z.string(),
-        jobId: z.string().describe("任务id")
+        jobId: z.string().describe('任务id'),
     }, async ({ mcpConfigFile, jobId }) => {
         await TcaClient.initConfig(mcpConfigFile);
+        const startTime = getNowCstDateTime();
         try {
             const res = await getJobDetail(jobId);
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.GetJobStatus, startTime, endTime, LogStatus.Success);
             return formatTextToolResult(JSON.stringify(res, null, 2), 'get job detail');
         }
         catch (error) {
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.GetJobStatus, startTime, endTime, LogStatus.Failed);
             return formatToolError(error, 'get job detail error!');
         }
     });
@@ -24,16 +31,24 @@ export default function registerJob(server) {
         -limit: 限制数量
         -state: 查询任务状态, （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）`, {
         mcpConfigFile: z.string(),
-        offset: z.number().default(0).describe("偏移量"),
-        limit: z.number().default(10).describe("限制数量"),
-        state: z.string().default("0,1,2,3,4,5").describe("查询任务状态,  （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）")
+        offset: z.number().default(0).describe('偏移量'),
+        limit: z.number().default(10).describe('限制数量'),
+        state: z
+            .string()
+            .default('0,1,2,3,4,5')
+            .describe('查询任务状态,  （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）'),
     }, async ({ mcpConfigFile, offset, limit, state }) => {
         await TcaClient.initConfig(mcpConfigFile);
+        const startTime = getNowCstDateTime();
         try {
             const res = await getJobList(offset, limit, state);
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.GetJobStatus, startTime, endTime, LogStatus.Success);
             return formatTextToolResult(JSON.stringify(res, null, 2), 'get job list');
         }
         catch (error) {
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.GetJobStatus, startTime, endTime, LogStatus.Failed, String(error));
             return formatToolError(error, 'get job list error!');
         }
     });

package/dist/tools/scan.js

@@ -1,22 +1,32 @@
-import { z } from "zod";
-import { startScan } from "../api/scan.js";
-import { formatTextToolResult, formatToolError } from "../utils/resp.js";
-import TcaClient from "../api/client.js";
+import { z } from 'zod';
+import { startScan } from '../api/scan.js';
+import { formatTextToolResult, formatToolError } from '../utils/resp.js';
+import TcaClient from '../api/client.js';
+import { recordOpLog, LogType, LogStatus } from '../api/oplog.js';
+import { getNowCstDateTime } from '../utils/time.js';
 export default function registerStartScan(server) {
     server.tool('start_scan', `启动tca代码分析 参数如下：
         -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
         -incrScan: 是否增量扫描
         -forceCreate: 如果已经存在扫描结果，是否强制启动新扫描`, {
         mcpConfigFile: z.string(),
-        incrScan: z.boolean().default(false).describe("是否增量扫描"),
-        forceCreate: z.boolean().default(false).describe("如果已经存在扫描结果，是否强制启动新扫描"),
+        incrScan: z.boolean().default(false).describe('是否增量扫描'),
+        forceCreate: z
+            .boolean()
+            .default(false)
+            .describe('如果已经存在扫描结果，是否强制启动新扫描'),
     }, async ({ mcpConfigFile, incrScan, forceCreate }) => {
         await TcaClient.initConfig(mcpConfigFile);
+        const startTime = getNowCstDateTime();
         try {
             const res = await startScan(incrScan, forceCreate);
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.ScanRemote, startTime, endTime, LogStatus.Success, 'mcp无法获取到返回结果, endTime仅调用接口的结束时间');
             return formatTextToolResult(JSON.stringify(res, null, 2), 'start tca scan');
         }
         catch (error) {
+            const endTime = getNowCstDateTime();
+            recordOpLog(LogType.ScanRemote, startTime, endTime, LogStatus.Failed, String(error), { incrScan: incrScan, forceCreate: forceCreate });
             return formatToolError(error, 'start tca scan error!');
         }
     });

package/dist/utils/time.js

@@ -0,0 +1,6 @@
+import { format } from 'date-fns';
+export function getNowCstDateTime() {
+    var now = new Date();
+    now.setHours(now.getHours() + 8);
+    return format(now, 'yyyy-MM-dd HH:mm:ss');
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "tca-mcp-server",
-  "version": "1.2.0",
+  "version": "1.3.2",
   "description": "",
   "main": "./dist/stdio.js",
   "scripts": {
     "build": "tsc",
     "test": "echo \"Error: no test specified\" && exit 1",
-    "start": "node dist/stdio.js"
+    "start": "node dist/stdio.js",
+    "prepare": "husky"
   },
   "bin": {
     "tca-mcp-stdio": "dist/stdio.js"
@@ -17,11 +18,25 @@
   "devDependencies": {
     "@types/ini": "^4.1.1",
     "@types/node": "^24.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.2",
+    "prettier": "^3.6.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "date-fns": "^4.1.0",
     "ini": "^5.0.0"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx}": [
+      "prettier --write",
+      "prettier --check"
+    ],
+    "*.{html,css,md}": [
+      "prettier --write",
+      "prettier --check"
+    ]
   }
 }

package/src/api/oplog.ts

@@ -0,0 +1,87 @@
+import TcaClient from './client.js';
+
+const opPluginType = 2;
+
+// 操作类型枚举，目前只有scan_remote
+export enum LogType {
+    ScanRemote = 'scan_remote',
+    GetReport = 'get_report',
+    GetIssue = 'get_issues',
+    GetAiSug = 'get_ai_sug',
+    GetJobStatus = 'get_job_status',
+}
+
+// 状态枚举， 1 成功，2 失败
+export enum LogStatus {
+    Success = 1,
+    Failed = 2,
+}
+
+/**
+ * 操作日志数据接口
+ */
+export interface OpLogData {
+    op_action: LogType;
+    start_time: string;
+    status?: LogStatus;
+    end_time?: string;
+    result_msg?: string;
+    op_plugin_type: number;
+    op_plugin_data?: Record<string, any>;
+}
+
+/**
+ * 记录MCP操作日志（带超时控制，不影响调用方）
+ * @param opType 操作类型
+ * @param startTime 开始时间
+ * @param endTime 结束时间（可选）
+ * @param status 操作状态（可选）
+ * @param resultMsg 结果信息（可选）
+ * @param opPluginData 插件操作数据（可选）
+ * @param timeout 超时时间，默认5000ms
+ */
+export function recordOpLog(
+    opType: LogType,
+    startTime: string,
+    endTime?: string,
+    status?: LogStatus,
+    resultMsg?: string,
+    opPluginData?: Record<string, any>,
+    timeout: number = 5000
+): void {
+    // IIFE，异步代码，不阻塞调用方
+    // 增加try catch，捕获异常但不抛出，仅输出错误，不影响主流程
+    if (TcaClient.getInstance().runInOA()) {
+        return;
+    }
+
+    (async () => {
+        try {
+            const clientInst = TcaClient.getInstance();
+
+            if (!clientInst.runInOA()) {
+                const { orgSid } = TcaClient.getcommonParams();
+                const path = `/server/main/api/orgs/${orgSid}/oplogs/pluginoprecords/`;
+
+                const logData: OpLogData = {
+                    op_action: opType,
+                    start_time: startTime,
+                    op_plugin_type: opPluginType,
+                    ...(endTime && { end_time: endTime }),
+                    ...(status && { status }),
+                    ...(resultMsg && { result_msg: resultMsg }),
+                    ...(opPluginData && { op_plugin_data: opPluginData }),
+                };
+
+                const timeoutPromise = new Promise((_, reject) =>
+                    setTimeout(() => reject(new Error('日志记录超时')), timeout)
+                );
+
+                await Promise.race([clientInst.request(path, 'POST', logData), timeoutPromise]);
+            }
+        } catch (error) {
+            // 仅在输出错误，但不影响调用方
+            console.error('记录操作日志失败:', error);
+        }
+    })();
+}

package/src/stdio.ts

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { registerTools } from "./tools/index.js";
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerTools } from './tools/index.js';
 
 // Create an MCP server
 const server = new McpServer({
-  name: "腾讯云代码分析(TCA)",
-  version: "1.0.0"
+    name: '腾讯云代码分析(TCA)',
+    version: '1.3.2',
 });
 
 // 从命令行获取参数，如果 --oa参数存在，则表示运行在OA环境，否则运行在SaaS环境
-const env = process.argv.includes("--oa") ? "oa" : "saas";
+const env = process.argv.includes('--oa') ? 'oa' : 'saas';
 process.env.TCA_ENV = env;
 
 registerTools(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.log("Server started");
+console.log('Server started');

package/src/tools/issue.ts

@@ -1,9 +1,10 @@
-import { z } from "zod";
-import TcaClient, { webUrlOA } from "../api/client.js";
-import { format } from "path";
-import { formatTextToolResult, formatToolError } from "../utils/resp.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { getIssueList } from "../api/issue.js";
+import { z } from 'zod';
+import TcaClient, { webUrlOA } from '../api/client.js';
+import { formatTextToolResult, formatToolError } from '../utils/resp.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { getIssueList } from '../api/issue.js';
+import { recordOpLog, LogType, LogStatus } from '../api/oplog.js';
+import { getNowCstDateTime } from '../utils/time.js';
 
 export default function registerIssueReport(server: McpServer) {
     server.tool(
@@ -17,21 +18,31 @@ export default function registerIssueReport(server: McpServer) {
         `,
         {
             mcpConfigFile: z.string(),
-            state: z.string().default("0,1,2,3,4,5"),
-            severity: z.string().default("0,1,2"),
+            state: z.string().default('0,1,2,3,4,5'),
+            severity: z.string().default('0,1,2'),
             offset: z.number().default(0),
             limit: z.number().default(10),
         },
         async ({ mcpConfigFile, state, severity, offset, limit }) => {
-            await TcaClient.initConfig(mcpConfigFile)
+            await TcaClient.initConfig(mcpConfigFile);
+            const startTime = getNowCstDateTime();
             try {
-                const res = await getIssueList(state, severity, offset, limit)
+                const res = await getIssueList(state, severity, offset, limit);
+                const endTime = getNowCstDateTime();
+                recordOpLog(LogType.GetIssue, startTime, endTime, LogStatus.Success);
                 return formatTextToolResult(JSON.stringify(res, null, 2), 'get issue list');
             } catch (error) {
-                return formatToolError(error, 'get issue list error')
+                const endTime = getNowCstDateTime();
+                recordOpLog(LogType.GetIssue, startTime, endTime, LogStatus.Failed, String(error), {
+                    state: state,
+                    severity: severity,
+                    offset: offset,
+                    limit: limit,
+                });
+                return formatToolError(error, 'get issue list error');
             }
         }
-    )
+    );
 
     server.tool(
         'tca_issue_report',
@@ -40,20 +51,24 @@ export default function registerIssueReport(server: McpServer) {
         -jobId: 任务id, 启动分析任务后，从返回结果中获取`,
         {
             mcpConfigFile: z.string(),
-            jobId: z.string().describe("jobId"),
+            jobId: z.string().describe('jobId'),
         },
         async ({ mcpConfigFile, jobId }) => {
-            await TcaClient.initConfig(mcpConfigFile)
-            const clientInst = TcaClient.getInstance()
+            await TcaClient.initConfig(mcpConfigFile);
+            const clientInst = TcaClient.getInstance();
+            const startTime = getNowCstDateTime();
             if (clientInst.runInOA()) {
-                const paramsOA = TcaClient.getcommonOAParams()
-                const path = `code-analysis/repos/${paramsOA.repoId}/projects/${paramsOA.projectId}/scan-history/${jobId}/result`
-                return formatTextToolResult(webUrlOA + path, 'tca issue report link')
+                const paramsOA = TcaClient.getcommonOAParams();
+                const path = `code-analysis/repos/${paramsOA.repoId}/projects/${paramsOA.projectId}/scan-history/${jobId}/result`;
+                return formatTextToolResult(webUrlOA + path, 'tca issue report link');
             } else {
-                const baseUrl = TcaClient.getInstance().baseUrl
-                const params = TcaClient.getcommonParams()
-                const path = `t/${params.orgSid}/p/${params.teamName}/repos/${params.repoId}/projects/${params.projectId}/jobs/${jobId}/result`
-                return formatTextToolResult(baseUrl + path, 'tca issue report link');
+                const baseUrl = TcaClient.getInstance().baseUrl;
+                const params = TcaClient.getcommonParams();
+                const path = `t/${params.orgSid}/p/${params.teamName}/repos/${params.repoId}/projects/${params.projectId}/jobs/${jobId}/result`;
+                const endTime = getNowCstDateTime();
+                var reportUrl = baseUrl + path;
+                recordOpLog(LogType.GetReport, startTime, endTime, LogStatus.Success, reportUrl);
+                return formatTextToolResult(reportUrl, 'tca issue report link');
             }
         }
     );

package/src/tools/job.ts

@@ -1,8 +1,10 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import TcaClient from "../api/client.js";
-import { formatTextToolResult, formatToolError } from "../utils/resp.js";
-import { getJobDetail, getJobList } from "../api/job.js";
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import TcaClient from '../api/client.js';
+import { formatTextToolResult, formatToolError } from '../utils/resp.js';
+import { getJobDetail, getJobList } from '../api/job.js';
+import { recordOpLog, LogType, LogStatus } from '../api/oplog.js';
+import { getNowCstDateTime } from '../utils/time.js';
 
 export default function registerJob(server: McpServer) {
     server.tool(
@@ -12,40 +14,61 @@ export default function registerJob(server: McpServer) {
         -jobId: 任务id`,
         {
             mcpConfigFile: z.string(),
-            jobId: z.string().describe("任务id")
+            jobId: z.string().describe('任务id'),
         },
         async ({ mcpConfigFile, jobId }) => {
-            await TcaClient.initConfig(mcpConfigFile)
+            await TcaClient.initConfig(mcpConfigFile);
+            const startTime = getNowCstDateTime();
             try {
-                const res = await getJobDetail(jobId)
+                const res = await getJobDetail(jobId);
+                const endTime = getNowCstDateTime();
+                recordOpLog(LogType.GetJobStatus, startTime, endTime, LogStatus.Success);
                 return formatTextToolResult(JSON.stringify(res, null, 2), 'get job detail');
             } catch (error) {
-                return formatToolError(error, 'get job detail error!')
+                const endTime = getNowCstDateTime();
+                recordOpLog(LogType.GetJobStatus, startTime, endTime, LogStatus.Failed);
+                return formatToolError(error, 'get job detail error!');
             }
         }
-    )
-    
+    );
+
     server.tool(
-        'job_list', 
+        'job_list',
         `获取当前任务列表, 参数如下：
         -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
         -offset: 偏移量
         -limit: 限制数量
-        -state: 查询任务状态, （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）`, 
+        -state: 查询任务状态, （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）`,
         {
             mcpConfigFile: z.string(),
-            offset: z.number().default(0).describe("偏移量"),
-            limit: z.number().default(10).describe("限制数量"),
-            state: z.string().default("0,1,2,3,4,5").describe("查询任务状态,  （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）")
+            offset: z.number().default(0).describe('偏移量'),
+            limit: z.number().default(10).describe('限制数量'),
+            state: z
+                .string()
+                .default('0,1,2,3,4,5')
+                .describe(
+                    '查询任务状态,  （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）'
+                ),
         },
         async ({ mcpConfigFile, offset, limit, state }) => {
-            await TcaClient.initConfig(mcpConfigFile)
+            await TcaClient.initConfig(mcpConfigFile);
+            const startTime = getNowCstDateTime();
             try {
-                const res = await getJobList(offset, limit, state)
+                const res = await getJobList(offset, limit, state);
+                const endTime = getNowCstDateTime();
+                recordOpLog(LogType.GetJobStatus, startTime, endTime, LogStatus.Success);
                 return formatTextToolResult(JSON.stringify(res, null, 2), 'get job list');
             } catch (error) {
-                return formatToolError(error, 'get job list error!')
+                const endTime = getNowCstDateTime();
+                recordOpLog(
+                    LogType.GetJobStatus,
+                    startTime,
+                    endTime,
+                    LogStatus.Failed,
+                    String(error)
+                );
+                return formatToolError(error, 'get job list error!');
             }
         }
-    )
+    );
 }

package/src/tools/scan.ts

@@ -1,9 +1,10 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { startScan } from "../api/scan.js";
-import { formatTextToolResult, formatToolError } from "../utils/resp.js";
-import TcaClient from "../api/client.js";
-
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { startScan } from '../api/scan.js';
+import { formatTextToolResult, formatToolError } from '../utils/resp.js';
+import TcaClient from '../api/client.js';
+import { recordOpLog, LogType, LogStatus } from '../api/oplog.js';
+import { getNowCstDateTime } from '../utils/time.js';
 
 export default function registerStartScan(server: McpServer) {
     server.tool(
@@ -14,16 +15,37 @@ export default function registerStartScan(server: McpServer) {
         -forceCreate: 如果已经存在扫描结果，是否强制启动新扫描`,
         {
             mcpConfigFile: z.string(),
-            incrScan: z.boolean().default(false).describe("是否增量扫描"),
-            forceCreate: z.boolean().default(false).describe("如果已经存在扫描结果，是否强制启动新扫描"),
+            incrScan: z.boolean().default(false).describe('是否增量扫描'),
+            forceCreate: z
+                .boolean()
+                .default(false)
+                .describe('如果已经存在扫描结果，是否强制启动新扫描'),
         },
         async ({ mcpConfigFile, incrScan, forceCreate }) => {
-            await TcaClient.initConfig(mcpConfigFile)
+            await TcaClient.initConfig(mcpConfigFile);
+            const startTime = getNowCstDateTime();
             try {
-                const res = await startScan(incrScan, forceCreate)
+                const res = await startScan(incrScan, forceCreate);
+                const endTime = getNowCstDateTime();
+                recordOpLog(
+                    LogType.ScanRemote,
+                    startTime,
+                    endTime,
+                    LogStatus.Success,
+                    'mcp无法获取到返回结果, endTime仅调用接口的结束时间'
+                );
                 return formatTextToolResult(JSON.stringify(res, null, 2), 'start tca scan');
             } catch (error) {
-                return formatToolError(error, 'start tca scan error!')
+                const endTime = getNowCstDateTime();
+                recordOpLog(
+                    LogType.ScanRemote,
+                    startTime,
+                    endTime,
+                    LogStatus.Failed,
+                    String(error),
+                    { incrScan: incrScan, forceCreate: forceCreate }
+                );
+                return formatToolError(error, 'start tca scan error!');
             }
         }
     );

package/src/utils/time.ts

@@ -0,0 +1,7 @@
+import { format } from 'date-fns';
+
+export function getNowCstDateTime(): string {
+    var now = new Date();
+    now.setHours(now.getHours() + 8);
+    return format(now, 'yyyy-MM-dd HH:mm:ss');
+}