Code Line Counter MCP

🚀 代碼行數統計MCP工具

這是一個MCP（模型上下文協議）工具，用於統計AI生成的代碼行數。藉助該工具，您能夠跟蹤並分析每次AI生成代碼的規模。

🚀 快速開始

此工具使用簡單，按照以下步驟操作即可開始使用：

1. 安裝依賴：

npm install

2. 啟動工具：

npm start

✨ 主要特性

1. count_code_lines：統計給定代碼的行數信息，涵蓋總行數、代碼行數、註釋行數和空行數。
2. get_statistics：獲取代碼行數的統計信息，支持按時間範圍篩選。

📦 安裝指南

在項目根目錄下，執行以下命令安裝所需依賴：

npm install

💻 使用示例

基礎用法

啟動工具：

npm start

高級用法

集成到MCP客戶端

要將此工具集成到MCP客戶端中，需執行以下步驟：

1. 啟動MCP服務器 首先，確保MCP服務器正在運行：

   npm start
   

   服務器將監聽標準輸入/輸出，等待MCP客戶端的連接。
2. 在MCP客戶端中配置工具 在您的MCP客戶端配置中，添加對此工具服務器的引用。具體的配置方式取決於您使用的MCP客戶端實現。 對於基於JSON的配置，通常需要添加類似以下的配置：

   {
     "tools": [
       {
         "name": "code-line-counter",
         "type": "process",
         "command": "node",
         "args": ["src/index.js"],
         "cwd": "/path/to/code-line-counter-mcp"
       }
     ]
   }
   

3. 使用工具 一旦集成完成，您可以在AI助手會話中使用以下工具：
   • count_code_lines - 當AI生成代碼時，自動調用此工具統計代碼行數。
   • get_statistics - 查詢歷史統計信息。 客戶端會自動處理工具的調用和結果返回。

示例調用

• 調用 count_code_lines 工具:

{
  "fileType": "javascript",
  "code": "function hello() {\n  // 這是一個註釋\n  console.log('Hello World');\n\n  return true;\n}"
}

• 調用 get_statistics 工具:

{
  "startTime": "2023-01-01T00:00:00Z",
  "endTime": "2023-12-31T23:59:59Z"
}

📚 詳細文檔

工具說明

count_code_lines

統計代碼行數的工具。

返回：代碼行數統計結果，包括總行數、代碼行數、註釋行數和空行數。

get_statistics

獲取代碼行數統計信息。

返回：代碼行數統計信息，包括總文件數、總行數、總代碼行數、總註釋行數、總空行數，以及按文件類型的分組統計。

數據持久化

工具會自動將統計結果保存到 data/code_line_data.json 文件中，確保重啟後數據不會丟失。

支持的文件類型

目前支持以下文件類型的註釋識別:

• JavaScript
• Python
• Java
• C++
• C
• Go
• Rust
• Swift
• Kotlin
• TypeScript

對於不支持的文件類型，仍將統計總行數、空行數，但註釋行數將為0。