tca-mcp-server 1.0.2 → 1.2.0

package/README.md

@@ -1,22 +1,78 @@
-### tools 接口
+# Tencent Cloud Code Analysis (TCA) MCP Server​
+> Official website (https://tca.tencent.com) MCP Server supporting MCP protocol for quickly starting code analysis and obtaining code analysis reports.
 
-配置需求：
-- token
-- username
-- url （可选，不对用户开放）
+Tencent Cloud Code Analysis (TCA), which started in 2012 (internal code name: CodeDog), is a cloud-native, distributed, and high-performance comprehensive code analysis and tracking management platform integrating numerous code analysis tools. Its main functions are to continuously track and analyze code, observe project code quality, and support teams in inheriting code culture. For more information about Tencent Cloud Code Assistant, please visit the official website usage guide: https://tca.tencent.com/document/zh/guide/.
 
-1，启动分析
-参数：
-- 仓库类型（git, svn）
-- 仓库地址
-- 仓库分支
-- 方案id
-- 本地分析/远程分析
-- 是否等待分析完成
+## TCA MCP Server Usage Steps​
 
-2，获取分析的进度
+### 1，Create relevant resources on the TCA official website
 
-3，获取当前仓库的方案列表
+Official website: https://tca.tencent.com/​
 
-4，接入仓库接口
+- step1: [Create a team] Visit the TCA official website, log in, select to create a team, fill in relevant information, and wait for the application to be approved:
+![create_team](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/org.png)
 
+- step2: [Create a project team] After creating the team, click to select the team, and create a project team after entering:
+![create a project team](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/project_team.png)
+
+- step3: [Access the code repository] After creating the project team, click to select the project team, and select to access the code repository that needs to be analyzed after entering:
+![repo](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/repo.png)
+
+- step4: [Create an analysis project] After successfully accessing the code repository, create an analysis project (it is recommended to first use the official experience plan in the figure for usage experience):
+![create a project](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/project.png)
+
+### 2, Create a `tca-mcp.ini` configuration file in the code repository
+
+Create a tca-mcp.ini configuration file in the code repository that needs code analysis. The configuration file is stored in the root directory of the code repository, and the content of the configuration file is as follows:
+
+```ini
+[config]
+project_id=<project_id>
+repo_id=<repo_id>
+org_sid=<org_sid>
+team_name=<team_name>
+```
+
+Relevant parameters can be obtained from the route of the corresponding page, as shown in the following figure:
+
+![tca-mcp-ini参数](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/tca-mcp-ini.png)
+
+Where `4iYVpci9nAX` corresponds to `org_sid`; `19485` corresponds to `repo_id`; `234521` corresponds to `project_id`; `first` corresponds to `team_name`. Fill in according to the actual situation.
+
+
+### 3, Configure TCA MCP Server
+```json
+{
+  "mcpServers": {
+    "tca-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "-p", "tca-mcp-server@latest", "tca-mcp-stdio"],
+      "env": {
+        "TCA_TOKEN": "<TCA_TOKEN>", 
+        "TCA_USER_NAME": "<TCA_USER_NAME>"
+      }
+    }
+  }
+}
+```
+The corresponding TCA_TOKEN and TCA_USER_NAME are obtained from the TCA official website, [Personal Center] -> [Personal Token], and can be accessed at https://tca.tencent.com/user/token.
+
+## TCA MCP Server Development Steps​
+> Requirements: nodejs >= 22.0.0
+
+1，npm run build
+2, Manually add test configuration:
+```bash
+{
+  "mcpServers": {
+    "tca-mcp-server-test": {
+      "command": "node",
+      "args": ["/path/to/tca-mcp-server/dist/stdio.js"],
+      "env": {
+        "TCA_TOKEN": "<TCA_TOKEN>", 
+        "TCA_USER_NAME": "<TCA_USER_NAME>",
+      }
+    }
+  }
+}
+```

package/README_zh.md

@@ -0,0 +1,80 @@
+# 腾讯云代码分析（TCA）MCP Server
+> 官网地址(https://tca.tencent.com) 支持 MCP 协议的 MCP Server，用于快速启动分析代码，获取代码分析报告。
+
+腾讯云代码分析（Tencent Code Analysis, TCA）起步于 2012 年（内部代号CodeDog），是集众多代码分析工具的云原生、分布式、高性能的代码综合分析跟踪管理平台，其主要功能是持续跟踪分析代码，观测项目代码质量，支撑团队传承代码文化。了解腾讯云代码助手更多信息，请访问官网使用指南: https://tca.tencent.com/document/zh/guide/
+
+
+## TCA MCP Server 使用步骤
+
+### 1，在TCA官网上创建相关资源
+
+官网地址: https://tca.tencent.com/
+
+- step1:【创建团队】 访问TCA官网，登录后选择创建一个团队，填写相关信息，等待申请通过：
+![创建团队](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/org.png)
+
+- step2:【创建项目组】 创建团队后，点击选择团队，进入后创建一个项目组：
+![创建项目组](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/project_team.png)
+
+- step3:【接入代码库】 创建项目组后，点击选择项目组，进入后选择接入需要进行分析的代码库：
+![接入代码库](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/repo.png)
+
+- step4:【创建分析项目】 成功接入代码库后，创建一个分析项目(推荐先使用图中的官方体验方案进行使用体验)：
+![创建分析项目](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/project.png)
+
+### 2，在代码库中创建 `tca-mcp.ini` 配置文件
+
+在需要进行代码分析的代码库中创建 **tca-mcp.ini** 配置文件，配置文件存放在代码库**根目录**下，配置文件内容如下：
+
+```ini
+[config]
+project_id=<project_id>
+repo_id=<repo_id>
+org_sid=<org_sid>
+team_name=<team_name>
+```
+
+相关参数可以从对应页面的路由中获取，如下图所示：
+
+![tca-mcp-ini参数](https://cnb.cool/tca/plugins/tca-mcp-server/-/git/raw/master/docs/images/tca-mcp-ini.png)
+其中`4iYVpci9nAX` 对应 `org_sid`； `19485` 对应 `repo_id`; `234521` 对应 `project_id`; `first` 对应 `team_name`。按照实际情况填写即可。
+
+
+### 3, 配置TCA MCP Server
+```json
+{
+  "mcpServers": {
+    "tca-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "-p", "tca-mcp-server@latest", "tca-mcp-stdio"],
+      "env": {
+        "TCA_TOKEN": "<TCA_TOKEN>", 
+        "TCA_USER_NAME": "<TCA_USER_NAME>"
+      }
+    }
+  }
+}
+```
+对应的 `TCA_TOKEN` 和 `TCA_USER_NAME` 从TCA官网, 【个人中心】 -> 【个人令牌
+】 中获取，可访问 https://tca.tencent.com/user/token 获取。
+
+
+## TCA MCP Server 开发步骤
+> 要求： nodejs >= 22.0.0
+
+1，npm run build   
+2, 手动添加测试配置:
+```bash
+{
+  "mcpServers": {
+    "tca-mcp-server-test": {
+      "command": "node",
+      "args": ["/path/to/tca-mcp-server/dist/stdio.js"],
+      "env": {
+        "TCA_TOKEN": "<TCA_TOKEN>", 
+        "TCA_USER_NAME": "<TCA_USER_NAME>",
+      }
+    }
+  }
+}
+```

package/dist/api/client.js

@@ -1,17 +1,26 @@
 import { createHash } from 'crypto';
+import * as ini from 'ini';
+import * as fs from 'fs';
+export const mainUrlOA = "http://server.codedog.woa.com/main/api/";
+export const analysisUrlOA = "http://server.codedog.woa.com/analysis/api/";
+export const webUrlOA = "https://codedog.woa.com/";
 export default class TcaClient {
     static instance = null;
+    static commonParams = null;
+    static commonOAParams = null;
     token;
     userName;
     baseUrl;
+    env;
     constructor(options) {
         this.token = options.token;
         this.userName = options.userName;
-        this.baseUrl = options.baseUrl || "https://tca.tencent.com/";
+        this.baseUrl = options.baseUrl;
+        this.env = options.env;
     }
     static initTcaClient(options) {
         if (!TcaClient.instance) {
-            const client = new TcaClient(options);
+            TcaClient.instance = new TcaClient(options);
         }
     }
     static getInstance() {
@@ -22,6 +31,42 @@ export default class TcaClient {
             throw new Error("TcaClient is not initialized");
         }
     }
+    static async initConfig(configPath) {
+        // 解析 ini 配置文件
+        const data = await fs.promises.readFile(configPath, 'utf-8');
+        const config = ini.parse(data);
+        const configSection = config.config || {};
+        if (TcaClient.instance?.runInOA()) {
+            TcaClient.commonOAParams = {
+                projectId: configSection.project_id,
+                repoId: configSection.repo_id
+            };
+        }
+        else {
+            TcaClient.commonParams = {
+                orgSid: configSection.org_sid,
+                teamName: configSection.team_name,
+                repoId: configSection.repo_id,
+                projectId: configSection.project_id,
+            };
+        }
+        return;
+    }
+    static getcommonParams() {
+        if (!TcaClient.commonParams) {
+            throw new Error("common params is not initialized");
+        }
+        return TcaClient.commonParams;
+    }
+    static getcommonOAParams() {
+        if (!TcaClient.commonOAParams) {
+            throw new Error("common OA params is not initialized");
+        }
+        return TcaClient.commonOAParams;
+    }
+    runInOA() {
+        return this.env === "oa";
+    }
     getHeader() {
         const timestamp = Math.floor(new Date().getTime() / 1000);
         const tokenSig = `${timestamp}${this.userName}#${this.token}#${this.userName}${timestamp}`;
@@ -32,27 +77,69 @@ export default class TcaClient {
             "TCA-TIMESTAMP": timestamp.toString(),
         };
     }
-    async request(path, method, data) {
-        const norBaseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
+    buildUrlWithNestedParams(url, params) {
+        const paramsObj = new URLSearchParams();
+        // 递归处理嵌套对象
+        function addParams(prefix, value) {
+            if (value === undefined || value === null) {
+                return;
+            }
+            if (typeof value === 'object' && !Array.isArray(value)) {
+                Object.entries(value).forEach(([key, val]) => {
+                    addParams(`${prefix}[${key}]`, val);
+                });
+            }
+            else if (Array.isArray(value)) {
+                value.forEach((item, index) => {
+                    addParams(`${prefix}[${index}]`, item);
+                });
+            }
+            else {
+                paramsObj.append(prefix, String(value));
+            }
+        }
+        Object.entries(params).forEach(([key, value]) => {
+            addParams(key, value);
+        });
+        return paramsObj.toString() ? `${url}?${paramsObj}` : url;
+    }
+    async request(path, method, data, params, baseUrl) {
+        if (!baseUrl) {
+            baseUrl = this.baseUrl;
+        }
+        const norBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
         const norPath = path.startsWith("/") ? path.slice(1) : path;
         const url = new URL(norPath, norBaseUrl);
-        const header = this.getHeader();
-        const options = {
-            method,
-            headers: {
+        var headers = {};
+        if (TcaClient.getInstance().runInOA()) {
+            headers = {
+                "Content-Type": "application/json",
+                "Authorization": `Token ${this.token}`,
+            };
+        }
+        else {
+            let header = this.getHeader();
+            headers = {
                 "Content-Type": "application/json",
                 "TCA-USERID": header['TCA-USERID'],
                 "TCA-TICKET": header['TCA-TICKET'],
                 "TCA-TIMESTAMP": header['TCA-TIMESTAMP']
-            },
+            };
+        }
+        const options = {
+            method,
+            headers: headers,
         };
         if (data) {
             options.body = JSON.stringify(data);
         }
+        if (params) {
+            url.search = this.buildUrlWithNestedParams(url.search, params);
+        }
         try {
             const response = await fetch(url, options);
             if (!response.ok) {
-                throw new Error(`Request failed with status ${response.status}`);
+                throw new Error(`Request failed with status ${response.status}, ${options.body}, ${options.headers}, ${options.method}, ${url}`);
             }
             const json = await response.json();
             return json;

package/dist/api/issue.js

@@ -0,0 +1,27 @@
+import TcaClient, { analysisUrlOA } from "./client.js";
+export async function getIssueList(state, severity, offset, limit) {
+    const method = "GET";
+    const clientInst = TcaClient.getInstance();
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams();
+        const path = `/projects/${pathParamsOA.projectId}/codelint/issues/`;
+        const params = {
+            state: state,
+            severity: severity,
+            offset: offset,
+            limit: limit
+        };
+        return clientInst.request(path, method, null, params, analysisUrlOA);
+    }
+    else {
+        const pathParams = TcaClient.getcommonParams();
+        const path = `/server/analysis/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/codelint/issues/`;
+        const params = {
+            state: state,
+            severity: severity,
+            offset: offset,
+            limit: limit
+        };
+        return clientInst.request(path, method, null, params);
+    }
+}

package/dist/api/job.js

@@ -0,0 +1,39 @@
+import TcaClient, { mainUrlOA } from "./client.js";
+export async function getJobList(offset, limit, state) {
+    const method = "GET";
+    const clientInst = TcaClient.getInstance();
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams();
+        const path = `/projects/${pathParamsOA.projectId}/jobs/`;
+        const params = {
+            "offset": offset,
+            "limit": limit,
+            "state": state,
+        };
+        return clientInst.request(path, method, null, params, mainUrlOA);
+    }
+    else {
+        const pathParams = TcaClient.getcommonParams();
+        const path = `/server/main/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/jobs/`;
+        const params = {
+            "offset": offset,
+            "limit": limit,
+            "state": state,
+        };
+        return clientInst.request(path, method, null, params);
+    }
+}
+export async function getJobDetail(jobId) {
+    const method = "GET";
+    const clientInst = TcaClient.getInstance();
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams();
+        const path = `/projects/${pathParamsOA.projectId}/jobs/${jobId}/detail/`;
+        return clientInst.request(path, method, null, null, mainUrlOA);
+    }
+    else {
+        const pathParams = TcaClient.getcommonParams();
+        const path = `/server/main/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/jobs/${jobId}/detail/`;
+        return clientInst.request(path, method, null, null);
+    }
+}

package/dist/api/scan.js

@@ -0,0 +1,25 @@
+import TcaClient, { mainUrlOA } from "./client.js";
+export async function startScan(incr_scan, force_create) {
+    const method = "POST";
+    const clientInst = TcaClient.getInstance();
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams();
+        const path = `/projects/${pathParamsOA.projectId}/scans/create/`;
+        const data = {
+            "incr_scan": incr_scan,
+            "created_from": "tca-mcp-server",
+            "force_create": force_create,
+        };
+        return clientInst.request(path, method, data, null, mainUrlOA);
+    }
+    else {
+        const pathParams = TcaClient.getcommonParams();
+        const path = `/server/main/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/scans/create/`;
+        const data = {
+            "incr_scan": incr_scan,
+            "created_from": "tca-mcp-server",
+            "force_create": force_create,
+        };
+        return clientInst.request(path, method, data);
+    }
+}

package/dist/stdio.js

@@ -1,24 +1,16 @@
 #!/usr/bin/env node
-import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
+import { registerTools } from "./tools/index.js";
 // Create an MCP server
 const server = new McpServer({
     name: "腾讯云代码分析(TCA)",
     version: "1.0.0"
 });
-// Add an addition tool
-server.tool("add", { a: z.number(), b: z.number() }, async ({ a, b }) => ({
-    content: [{ type: "text", text: String(a + b) }]
-}));
-// Add a dynamic greeting resource
-server.resource("greeting", new ResourceTemplate("greeting://{name}", { list: undefined }), async (uri, { name }) => ({
-    contents: [{
-            uri: uri.href,
-            text: `Hello, ${name}!`
-        }]
-}));
-// Start receiving messages on stdin and sending messages on stdout
+// 从命令行获取参数，如果 --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");

package/dist/tools/index.js

@@ -0,0 +1,15 @@
+import TcaClient from "../api/client.js";
+import registerStartScan from "./scan.js";
+import registerJob from "./job.js";
+import registerIssueReport from "./issue.js";
+export function registerTools(server) {
+    TcaClient.initTcaClient({
+        "token": process.env.TCA_TOKEN || "",
+        "userName": process.env.TCA_USER_NAME || "",
+        "baseUrl": process.env.TCA_BASE_URL || "https://tca.tencent.com/",
+        "env": process.env.TCA_ENV || "saas"
+    });
+    registerStartScan(server);
+    registerJob(server);
+    registerIssueReport(server);
+}

package/dist/tools/issue.js

@@ -1 +1,48 @@
-export {};
+import { z } from "zod";
+import TcaClient, { webUrlOA } from "../api/client.js";
+import { formatTextToolResult, formatToolError } from "../utils/resp.js";
+import { getIssueList } from "../api/issue.js";
+export default function registerIssueReport(server) {
+    server.tool('tca_issue_list', `获取当前项目未解决的问题列表, 参数如下：
+        -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
+        -state: 查询任务状态, （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）
+        -severity: 问题严重程度, （0为低，1为中，2为高）
+        -offset: 偏移量
+        -limit: 限制数量
+        `, {
+        mcpConfigFile: z.string(),
+        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);
+        try {
+            const res = await getIssueList(state, severity, offset, limit);
+            return formatTextToolResult(JSON.stringify(res, null, 2), 'get issue list');
+        }
+        catch (error) {
+            return formatToolError(error, 'get issue list error');
+        }
+    });
+    server.tool('tca_issue_report', `tca报告链接, 参数如下：
+        -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
+        -jobId: 任务id, 启动分析任务后，从返回结果中获取`, {
+        mcpConfigFile: z.string(),
+        jobId: z.string().describe("jobId"),
+    }, async ({ mcpConfigFile, jobId }) => {
+        await TcaClient.initConfig(mcpConfigFile);
+        const clientInst = TcaClient.getInstance();
+        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');
+        }
+        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');
+        }
+    });
+}

package/dist/tools/job.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import TcaClient from "../api/client.js";
+import { formatTextToolResult, formatToolError } from "../utils/resp.js";
+import { getJobDetail, getJobList } from "../api/job.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")
+    }, async ({ mcpConfigFile, jobId }) => {
+        await TcaClient.initConfig(mcpConfigFile);
+        try {
+            const res = await getJobDetail(jobId);
+            return formatTextToolResult(JSON.stringify(res, null, 2), 'get job detail');
+        }
+        catch (error) {
+            return formatToolError(error, 'get job detail error!');
+        }
+    });
+    server.tool('job_list', `获取当前任务列表, 参数如下：
+        -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
+        -offset: 偏移量
+        -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）")
+    }, async ({ mcpConfigFile, offset, limit, state }) => {
+        await TcaClient.initConfig(mcpConfigFile);
+        try {
+            const res = await getJobList(offset, limit, state);
+            return formatTextToolResult(JSON.stringify(res, null, 2), 'get job list');
+        }
+        catch (error) {
+            return formatToolError(error, 'get job list error!');
+        }
+    });
+}

package/dist/tools/scan.js

@@ -1 +1,23 @@
-export {};
+import { z } from "zod";
+import { startScan } from "../api/scan.js";
+import { formatTextToolResult, formatToolError } from "../utils/resp.js";
+import TcaClient from "../api/client.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("如果已经存在扫描结果，是否强制启动新扫描"),
+    }, async ({ mcpConfigFile, incrScan, forceCreate }) => {
+        await TcaClient.initConfig(mcpConfigFile);
+        try {
+            const res = await startScan(incrScan, forceCreate);
+            return formatTextToolResult(JSON.stringify(res, null, 2), 'start tca scan');
+        }
+        catch (error) {
+            return formatToolError(error, 'start tca scan error!');
+        }
+    });
+}

package/dist/utils/resp.js

@@ -0,0 +1,21 @@
+export function formatTextToolResult(text, toolName) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text
+            }
+        ]
+    };
+}
+export function formatToolError(error, toolName) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Error ${toolName}:\n${error instanceof Error ? error.message : String(error)}`
+            }
+        ],
+        isError: true
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tca-mcp-server",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "",
   "main": "./dist/stdio.js",
   "scripts": {
@@ -15,11 +15,13 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
+    "@types/ini": "^4.1.1",
     "@types/node": "^24.0.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1"
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "ini": "^5.0.0"
   }
 }

package/src/api/client.ts

@@ -1,11 +1,23 @@
 import { createHash } from 'crypto';
+import * as ini from 'ini';
+import * as fs from 'fs';
+
+export const mainUrlOA = "http://server.codedog.woa.com/main/api/"
+export const analysisUrlOA = "http://server.codedog.woa.com/analysis/api/"
+export const webUrlOA = "https://codedog.woa.com/"
+
+export interface CommonParams {
+    orgSid: string;
+    teamName: string;
+    repoId?: string;
+    projectId?: string;
+}
 
 export interface TcaClientOptions {
     token: string;
     userName: string;
-    orgSid: string;
-    projectName: string;
-    baseUrl?: string;
+    baseUrl: string;
+    env: string;
 }
 
 export interface TcaClientHeaders {
@@ -20,21 +32,31 @@ type RequestOptions = {
     body?: any;
 }
 
+export interface OACommonParams {
+    projectId?: string;
+    repoId?: string;
+}
+
 export default class TcaClient {
     private static instance: TcaClient | null = null;
+    private static commonParams: CommonParams | null = null;
+    private static commonOAParams: OACommonParams | null = null;
 
     private token: string;
     private userName: string;
-    private baseUrl: string;
+    public baseUrl: string;
+    public env: string;
 
     constructor(options: TcaClientOptions) {
         this.token = options.token;
         this.userName = options.userName;
-        this.baseUrl = options.baseUrl || "https://tca.tencent.com/";
+        this.baseUrl = options.baseUrl;
+        this.env = options.env;
     }
+
     static initTcaClient(options: TcaClientOptions) {
         if (!TcaClient.instance) {
-            const client = new TcaClient(options);   
+            TcaClient.instance = new TcaClient(options);   
         }
     }
     static getInstance(): TcaClient {
@@ -45,6 +67,45 @@ export default class TcaClient {
         }
     }
 
+    static async initConfig(configPath: string) {
+        // 解析 ini 配置文件
+        const data = await fs.promises.readFile(configPath, 'utf-8');
+        const config = ini.parse(data);
+        const configSection = config.config || {};
+
+        if (TcaClient.instance?.runInOA()) {
+            TcaClient.commonOAParams = {
+                projectId: configSection.project_id,
+                repoId: configSection.repo_id
+            }
+        } else {
+            TcaClient.commonParams = {
+                orgSid: configSection.org_sid,
+                teamName: configSection.team_name,
+                repoId: configSection.repo_id,
+                projectId: configSection.project_id,
+            }
+        }
+        return 
+    }
+    static getcommonParams(): CommonParams{
+        if (!TcaClient.commonParams) {
+            throw new Error("common params is not initialized");
+        }
+        return TcaClient.commonParams;
+    }
+
+    static getcommonOAParams(): OACommonParams {
+        if (!TcaClient.commonOAParams) {
+            throw new Error("common OA params is not initialized");
+        }
+        return TcaClient.commonOAParams;
+    }
+
+    runInOA(): boolean {
+        return this.env === "oa";
+    }
+
     getHeader(): TcaClientHeaders {
         const timestamp = Math.floor(new Date().getTime() / 1000);
         const tokenSig = `${timestamp}${this.userName}#${this.token}#${this.userName}${timestamp}`;
@@ -55,28 +116,73 @@ export default class TcaClient {
             "TCA-TIMESTAMP": timestamp.toString(),
         }
     }
+    buildUrlWithNestedParams(url: string, params: any): string {
+        const paramsObj = new URLSearchParams();
+        
+        // 递归处理嵌套对象
+        function addParams(prefix: string, value: any) {
+        if (value === undefined || value === null) {
+            return;
+        }
+        
+        if (typeof value === 'object' && !Array.isArray(value)) {
+            Object.entries(value).forEach(([key, val]) => {
+            addParams(`${prefix}[${key}]`, val);
+            });
+        } else if (Array.isArray(value)) {
+            value.forEach((item, index) => {
+            addParams(`${prefix}[${index}]`, item);
+            });
+        } else {
+            paramsObj.append(prefix, String(value));
+        }
+        }
+        
+        Object.entries(params).forEach(([key, value]) => {
+        addParams(key, value);
+        });
+        
+        return paramsObj.toString() ? `${url}?${paramsObj}` : url;
+    }
+  
 
-    async request<T>(path: string, method: string, data?: any): Promise<T> {
-        const norBaseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
+    async request<T>(path: string, method: string, data?: any, params?: any, baseUrl?: any): Promise<T> {
+        if (!baseUrl) {
+            baseUrl = this.baseUrl;
+        }
+        const norBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
         const norPath = path.startsWith("/") ? path.slice(1) : path;
         const url = new URL(norPath, norBaseUrl);
-        const header = this.getHeader();
-        const options: RequestOptions = {
-            method,
-            headers: {
+        
+        var headers = {};
+        if (TcaClient.getInstance().runInOA()) {
+            headers = {
+                "Content-Type": "application/json",
+                "Authorization": `Token ${this.token}`,
+            }
+        } else {
+            let header = this.getHeader();
+            headers = {
                 "Content-Type": "application/json",
                 "TCA-USERID": header['TCA-USERID'],
                 "TCA-TICKET": header['TCA-TICKET'],
                 "TCA-TIMESTAMP": header['TCA-TIMESTAMP']
-            },
+            }
+        }
+        const options: RequestOptions = {
+            method,
+            headers: headers,
         };
         if (data) {
             options.body = JSON.stringify(data);
         }
+        if (params) {
+            url.search = this.buildUrlWithNestedParams(url.search, params);
+        }
         try {
             const response = await fetch(url, options)
             if (!response.ok) {
-                throw new Error(`Request failed with status ${response.status}`);
+                throw new Error(`Request failed with status ${response.status}, ${options.body}, ${options.headers}, ${options.method}, ${url}`);
             }
             const json = await response.json();
             return json as T;

package/src/api/issue.ts

@@ -0,0 +1,29 @@
+import TcaClient, { analysisUrlOA } from "./client.js"
+
+
+export async function getIssueList(state: string, severity: string, offset: number, limit: number) {
+    const method = "GET"
+    const clientInst = TcaClient.getInstance()
+    
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams()
+        const path = `/projects/${pathParamsOA.projectId}/codelint/issues/`
+        const params = {
+            state: state,
+            severity: severity,
+            offset: offset,
+            limit: limit
+        }
+        return clientInst.request(path, method, null, params, analysisUrlOA)
+    } else {
+        const pathParams = TcaClient.getcommonParams()
+        const path = `/server/analysis/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/codelint/issues/`
+        const params = {
+            state: state,
+            severity: severity,
+            offset: offset,
+            limit: limit
+        }
+        return clientInst.request(path, method, null, params)
+    }
+}

package/src/api/job.ts

@@ -0,0 +1,39 @@
+import TcaClient, { mainUrlOA } from "./client.js"
+
+export async function getJobList(offset: number, limit: number, state: string) {
+    const method = "GET"
+    const clientInst = TcaClient.getInstance()
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams()
+        const path = `/projects/${pathParamsOA.projectId}/jobs/`
+        const params = {
+            "offset": offset,
+            "limit": limit,
+            "state": state,
+        }
+        return clientInst.request(path, method, null, params, mainUrlOA)
+    } else {
+        const pathParams = TcaClient.getcommonParams()
+        const path = `/server/main/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/jobs/`
+        const params = {
+            "offset": offset,
+            "limit": limit,
+            "state": state,
+        }
+        return clientInst.request(path, method, null, params)
+    }
+}
+
+export async function getJobDetail(jobId: string) {
+    const method = "GET"
+    const clientInst = TcaClient.getInstance()
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams()
+        const path = `/projects/${pathParamsOA.projectId}/jobs/${jobId}/detail/`
+        return clientInst.request(path, method, null, null, mainUrlOA)
+    } else {
+        const pathParams = TcaClient.getcommonParams()
+        const path = `/server/main/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/jobs/${jobId}/detail/`
+        return clientInst.request(path, method, null, null)
+    }
+}

package/src/api/scan.ts

@@ -0,0 +1,39 @@
+import TcaClient, { CommonParams, mainUrlOA, analysisUrlOA } from "./client.js"
+
+export interface startScanParams {
+    "token": string,
+    "userName": string,
+    "orgSid": string,
+    "projectName": string,
+    "scanName": string,
+}
+
+export interface startScanData {
+    "incr_scan": boolean,
+    "created_from": string,
+    "force_create": boolean,
+}
+
+export async function startScan(incr_scan: boolean, force_create: boolean) {
+    const method = "POST"
+    const clientInst = TcaClient.getInstance()
+    if (clientInst.runInOA()) {
+        const pathParamsOA = TcaClient.getcommonOAParams()
+        const path = `/projects/${pathParamsOA.projectId}/scans/create/`
+        const data = {
+            "incr_scan": incr_scan,
+            "created_from": "tca-mcp-server",
+            "force_create": force_create,
+        } as startScanData
+        return clientInst.request(path, method, data, null, mainUrlOA)
+    } else {
+        const pathParams = TcaClient.getcommonParams()
+        const path = `/server/main/api/orgs/${pathParams.orgSid}/teams/${pathParams.teamName}/repos/${pathParams.repoId}/projects/${pathParams.projectId}/scans/create/`
+        const data = {
+            "incr_scan": incr_scan,
+            "created_from": "tca-mcp-server",
+            "force_create": force_create,
+        } as startScanData
+        return clientInst.request(path, method, data)
+    }
+}

package/src/stdio.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
-import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
+import { registerTools } from "./tools/index.js";
 
 // Create an MCP server
 const server = new McpServer({
@@ -10,27 +10,11 @@ const server = new McpServer({
   version: "1.0.0"
 });
 
-// Add an addition tool
-server.tool("add",
-  { a: z.number(), b: z.number() },
-  async ({ a, b }) => ({
-    content: [{ type: "text", text: String(a + b) }]
-  })
-);
+// 从命令行获取参数，如果 --oa参数存在，则表示运行在OA环境，否则运行在SaaS环境
+const env = process.argv.includes("--oa") ? "oa" : "saas";
+process.env.TCA_ENV = env;
 
-// Add a dynamic greeting resource
-server.resource(
-  "greeting",
-  new ResourceTemplate("greeting://{name}", { list: undefined }),
-  async (uri, { name }) => ({
-    contents: [{
-      uri: uri.href,
-      text: `Hello, ${name}!`
-    }]
-  })
-);
-
-// Start receiving messages on stdin and sending messages on stdout
+registerTools(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.log("Server started");
+console.log("Server started");

package/src/tools/index.ts

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import TcaClient from "../api/client.js";
+import registerStartScan from "./scan.js";
+import registerJob from "./job.js";
+import registerIssueReport from "./issue.js";
+
+export function registerTools(server: McpServer) {
+    TcaClient.initTcaClient({
+        "token": process.env.TCA_TOKEN || "",
+        "userName": process.env.TCA_USER_NAME || "",
+        "baseUrl": process.env.TCA_BASE_URL || "https://tca.tencent.com/",
+        "env": process.env.TCA_ENV || "saas"
+    })
+    registerStartScan(server);
+    registerJob(server);
+    registerIssueReport(server);
+}

package/src/tools/issue.ts

@@ -0,0 +1,60 @@
+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";
+
+export default function registerIssueReport(server: McpServer) {
+    server.tool(
+        'tca_issue_list',
+        `获取当前项目未解决的问题列表, 参数如下：
+        -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
+        -state: 查询任务状态, （0为等待中，1为执行中，2为关闭，3为入库中，4正在初始化, 5初始化完成 可多选，格式为1,2,3）
+        -severity: 问题严重程度, （0为低，1为中，2为高）
+        -offset: 偏移量
+        -limit: 限制数量
+        `,
+        {
+            mcpConfigFile: z.string(),
+            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)
+            try {
+                const res = await getIssueList(state, severity, offset, limit)
+                return formatTextToolResult(JSON.stringify(res, null, 2), 'get issue list');
+            } catch (error) {
+                return formatToolError(error, 'get issue list error')
+            }
+        }
+    )
+
+    server.tool(
+        'tca_issue_report',
+        `tca报告链接, 参数如下：
+        -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
+        -jobId: 任务id, 启动分析任务后，从返回结果中获取`,
+        {
+            mcpConfigFile: z.string(),
+            jobId: z.string().describe("jobId"),
+        },
+        async ({ mcpConfigFile, jobId }) => {
+            await TcaClient.initConfig(mcpConfigFile)
+            const clientInst = TcaClient.getInstance()
+            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')
+            } 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');
+            }
+        }
+    );
+}

package/src/tools/job.ts

@@ -0,0 +1,51 @@
+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";
+
+export default function registerJob(server: McpServer) {
+    server.tool(
+        'job_detail',
+        `获取任务详情, 参数如下：
+        -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
+        -jobId: 任务id`,
+        {
+            mcpConfigFile: z.string(),
+            jobId: z.string().describe("任务id")
+        },
+        async ({ mcpConfigFile, jobId }) => {
+            await TcaClient.initConfig(mcpConfigFile)
+            try {
+                const res = await getJobDetail(jobId)
+                return formatTextToolResult(JSON.stringify(res, null, 2), 'get job detail');
+            } catch (error) {
+                return formatToolError(error, 'get job detail error!')
+            }
+        }
+    )
+    
+    server.tool(
+        'job_list', 
+        `获取当前任务列表, 参数如下：
+        -mcpConfigFile: mcp配置文件路径，当前项目根目录查找 tca-mcp.ini（绝对路径）
+        -offset: 偏移量
+        -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）")
+        },
+        async ({ mcpConfigFile, offset, limit, state }) => {
+            await TcaClient.initConfig(mcpConfigFile)
+            try {
+                const res = await getJobList(offset, limit, state)
+                return formatTextToolResult(JSON.stringify(res, null, 2), 'get job list');
+            } catch (error) {
+                return formatToolError(error, 'get job list error!')
+            }
+        }
+    )
+}

package/src/tools/scan.ts

@@ -0,0 +1,30 @@
+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";
+
+
+export default function registerStartScan(server: McpServer) {
+    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("如果已经存在扫描结果，是否强制启动新扫描"),
+        },
+        async ({ mcpConfigFile, incrScan, forceCreate }) => {
+            await TcaClient.initConfig(mcpConfigFile)
+            try {
+                const res = await startScan(incrScan, forceCreate)
+                return formatTextToolResult(JSON.stringify(res, null, 2), 'start tca scan');
+            } catch (error) {
+                return formatToolError(error, 'start tca scan error!')
+            }
+        }
+    );
+}

package/src/utils/resp.ts

@@ -0,0 +1,24 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+
+export function formatTextToolResult(text: string, toolName: string): CallToolResult {
+  return {
+    content: [
+      {
+        type: 'text',
+        text
+      }
+    ]
+  };
+}
+
+export function formatToolError(error: unknown, toolName: string): CallToolResult {
+    return {
+    content: [
+        {
+        type: 'text',
+        text: `Error ${toolName}:\n${error instanceof Error ? error.message : String(error)}`
+        }
+    ],
+    isError: true
+    };
+}

package/dist/api/project.js

@@ -1 +0,0 @@
-export {};

package/dist/tools/project.js

@@ -1 +0,0 @@
-export {};

package/dist/tools/repo.js

@@ -1 +0,0 @@
-export {};

package/src/api/project.ts

@@ -1,2 +0,0 @@
-import TcaClient from "./client.js";
-