iflow-mcp_yezere-codeql_n1ght_mcp_server 0.1.0__tar.gz

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/3442_process.log

@@ -0,0 +1,6 @@
+[2026-02-06] [INFO] 步骤1：获取项目完成 - Fork和克隆成功
+[2026-02-06] [INFO] 步骤2：阅读代码开始 - 分析项目类型和配置
+[2026-02-06] [INFO] 步骤2：阅读代码完成 - Python MCP服务端项目，使用FastMCP，支持stdio协议
+[2026-02-06] [INFO] 步骤3：本地测试开始 - 安装依赖并构建项目
+[2026-02-06] [INFO] 步骤3：本地测试完成 - 成功构建并测试，发现5个工具
+[2026-02-06] [INFO] 步骤4：创建并推送iflow分支完成 - 分支已推送到远程仓库

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_yezere-codeql_n1ght_mcp_server
+Version: 0.1.0
+Summary: MCP server for CodeQL N1ght tool integration
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.1.0
+Description-Content-Type: text/markdown
+
+# CodeQL N1ght MCP Server
+
+A Model Context Protocol (MCP) server for integrating CodeQL N1ght tool with AI assistants.
+
+## Overview
+
+This MCP server provides a standardized interface for AI assistants to interact with the CodeQL N1ght tool, enabling automated code analysis workflows including environment setup, database creation, and security scanning.
+
+## Features
+
+- **Environment Installation**: One-click setup of JDK, Ant, and CodeQL dependencies
+- **Database Creation**: Create CodeQL databases from JAR/WAR/ZIP files with configurable decompilers
+- **Security Scanning**: Execute security scans with customizable query packs
+- **Parallel Processing**: Support for goroutines and multi-threading
+- **Flexible Configuration**: Customizable paths, timeouts, and caching options
+
+## Available Tools
+
+### `version`
+Get version or help information from the CodeQL N1ght executable.
+
+### `install_environment`
+Install required dependencies (JDK, Ant, CodeQL) with optional custom URLs.
+
+### `create_database`
+Create a CodeQL database from target files (JAR/WAR/ZIP) with options for:
+- Decompiler selection (procyon/fernflower)
+- Dependency handling (none/all)
+- Parallel processing
+- Cache management
+
+### `scan_database`
+Execute security scans on CodeQL databases with configurable:
+- Database and query pack paths
+- Parallel processing options
+- Cache control
+
+### `run_codeql_n1ght`
+Generic interface for direct command execution with custom arguments.
+
+## Installation
+
+1. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+2. Ensure the CodeQL N1ght executable is available at the configured path (default: `J:\mcp\codeql-n1ght.exe`)
+
+## Usage
+
+Run the MCP server in STDIO mode:
+
+```bash
+python codeql_n1ght_mcp_server.py
+```
+
+## Configuration
+
+- **Default Executable Path**: `J:\mcp\codeql-n1ght.exe`
+- **Path Compatibility**: Supports both Windows (`J:\path`) and Unix-style (`/j:/path`) path formats
+- **Timeouts**: Configurable per operation (default: 10 minutes for general operations, 20 hours for database/scan operations)
+
+## Response Format
+
+All tools return a standardized response format:
+```json
+{
+  "returncode": 0,
+  "stdout": "command output",
+  "stderr": "error output",
+  "timeout": false
+}
+```
+
+## Error Handling
+
+- **Executable Not Found**: Returns error if CodeQL N1ght executable is missing
+- **Invalid Parameters**: Validates decompiler and dependency options
+- **Timeout Management**: Configurable timeouts with process termination
+- **Path Resolution**: Automatic path normalization and validation
+
+## License
+
+This project is open source and available under the MIT License.

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/README.md

@@ -0,0 +1,85 @@
+# CodeQL N1ght MCP Server
+
+A Model Context Protocol (MCP) server for integrating CodeQL N1ght tool with AI assistants.
+
+## Overview
+
+This MCP server provides a standardized interface for AI assistants to interact with the CodeQL N1ght tool, enabling automated code analysis workflows including environment setup, database creation, and security scanning.
+
+## Features
+
+- **Environment Installation**: One-click setup of JDK, Ant, and CodeQL dependencies
+- **Database Creation**: Create CodeQL databases from JAR/WAR/ZIP files with configurable decompilers
+- **Security Scanning**: Execute security scans with customizable query packs
+- **Parallel Processing**: Support for goroutines and multi-threading
+- **Flexible Configuration**: Customizable paths, timeouts, and caching options
+
+## Available Tools
+
+### `version`
+Get version or help information from the CodeQL N1ght executable.
+
+### `install_environment`
+Install required dependencies (JDK, Ant, CodeQL) with optional custom URLs.
+
+### `create_database`
+Create a CodeQL database from target files (JAR/WAR/ZIP) with options for:
+- Decompiler selection (procyon/fernflower)
+- Dependency handling (none/all)
+- Parallel processing
+- Cache management
+
+### `scan_database`
+Execute security scans on CodeQL databases with configurable:
+- Database and query pack paths
+- Parallel processing options
+- Cache control
+
+### `run_codeql_n1ght`
+Generic interface for direct command execution with custom arguments.
+
+## Installation
+
+1. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+2. Ensure the CodeQL N1ght executable is available at the configured path (default: `J:\mcp\codeql-n1ght.exe`)
+
+## Usage
+
+Run the MCP server in STDIO mode:
+
+```bash
+python codeql_n1ght_mcp_server.py
+```
+
+## Configuration
+
+- **Default Executable Path**: `J:\mcp\codeql-n1ght.exe`
+- **Path Compatibility**: Supports both Windows (`J:\path`) and Unix-style (`/j:/path`) path formats
+- **Timeouts**: Configurable per operation (default: 10 minutes for general operations, 20 hours for database/scan operations)
+
+## Response Format
+
+All tools return a standardized response format:
+```json
+{
+  "returncode": 0,
+  "stdout": "command output",
+  "stderr": "error output",
+  "timeout": false
+}
+```
+
+## Error Handling
+
+- **Executable Not Found**: Returns error if CodeQL N1ght executable is missing
+- **Invalid Parameters**: Validates decompiler and dependency options
+- **Timeout Management**: Configurable timeouts with process termination
+- **Path Resolution**: Automatic path normalization and validation
+
+## License
+
+This project is open source and available under the MIT License.

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/codeql_n1ght_mcp_server.py

@@ -0,0 +1,267 @@
+import asyncio
+import logging
+import os
+from typing import List, Optional, Dict, Any
+
+from mcp.server import FastMCP
+
+# 注意：STDIO 模式下不要向 stdout 打印任何非协议内容，使用 logging（写入 stderr）记录日志
+logging.basicConfig(level=logging.INFO)
+
+APP_NAME = "codeql_n1ght_mcp"
+# 默认可执行文件路径（兼容传入 "/j:/mcp/codeql-n1ght.exe" 的写法）
+EXE_PATH = r"J:\\mcp\\codeql-n1ght.exe"
+
+app = FastMCP(APP_NAME)
+
+
+def _resolve_exe_path(custom_path: Optional[str]) -> str:
+    """返回可执行文件的绝对路径，优先使用传入路径。兼容类似 "/j:/mcp/codeql-n1ght.exe" 的写法。"""
+    path = (custom_path or EXE_PATH).strip()
+    if path.startswith("/") and len(path) > 2 and path[2] == ":":
+        path = path[1:]
+    return os.path.abspath(path)
+
+
+async def _run_subprocess(cmd: List[str], cwd: Optional[str], timeout: Optional[float]) -> Dict[str, Any]:
+    """以异步方式运行子进程，捕获 stdout/stderr，返回 {returncode, stdout, stderr, timeout}."""
+    logging.info("Running command: %s", " ".join(cmd))
+    if cwd:
+        logging.info("Working directory: %s", cwd)
+
+    proc = await asyncio.create_subprocess_exec(
+        *cmd,
+        cwd=cwd,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+    )
+
+    try:
+        stdout_b, stderr_b = await asyncio.wait_for(proc.communicate(), timeout=timeout)
+        timed_out = False
+    except asyncio.TimeoutError:
+        try:
+            proc.kill()
+        except ProcessLookupError:
+            pass
+        return {
+            "returncode": None,
+            "stdout": "",
+            "stderr": f"Process timeout after {timeout} seconds",
+            "timeout": True,
+        }
+
+    stdout = stdout_b.decode(errors="replace") if stdout_b else ""
+    stderr = stderr_b.decode(errors="replace") if stderr_b else ""
+
+    return {
+        "returncode": proc.returncode,
+        "stdout": stdout,
+        "stderr": stderr,
+        "timeout": timed_out,
+    }
+
+
+@app.tool()
+async def run_codeql_n1ght(
+    args: Optional[List[str]] = None,
+    exe_path: Optional[str] = None,
+    cwd: Optional[str] = None,
+    timeout_seconds: Optional[float] = 600.0,
+) -> Dict[str, Any]:
+    """
+    通用执行接口：直接传入参数数组，运行 codeql-n1ght.exe。
+
+    - args 例如：["-install"]、["-database", "your.jar", "-decompiler", "fernflower"] 等。
+    - exe_path 可选，覆盖默认可执行路径。
+    - cwd 可选，子进程工作目录。
+    - timeout_seconds 超时（秒）。
+    """
+    resolved_path = _resolve_exe_path(exe_path)
+    if not os.path.exists(resolved_path):
+        return {
+            "returncode": None,
+            "stdout": "",
+            "stderr": f"Executable not found: {resolved_path}",
+            "timeout": False,
+        }
+
+    args = args or []
+    cmd = [resolved_path, *args]
+    return await _run_subprocess(cmd, cwd=cwd, timeout=timeout_seconds)
+
+
+@app.tool()
+async def version(
+    exe_path: Optional[str] = None,
+    timeout_seconds: Optional[float] = 60.0,
+) -> Dict[str, Any]:
+    """获取可执行文件版本或帮助信息：先尝试 --version，失败回退 --help。"""
+    resolved_path = _resolve_exe_path(exe_path)
+    if not os.path.exists(resolved_path):
+        return {
+            "returncode": None,
+            "stdout": "",
+            "stderr": f"Executable not found: {resolved_path}",
+            "timeout": False,
+        }
+
+    # 先尝试 --version
+    res = await _run_subprocess([resolved_path, "--version"], cwd=None, timeout=timeout_seconds)
+    if res.get("returncode") == 0 and res.get("stdout"):
+        return res
+
+    # 回退 --help
+    return await _run_subprocess([resolved_path, "--help"], cwd=None, timeout=timeout_seconds)
+
+
+@app.tool()
+async def install_environment(
+    jdk_url: Optional[str] = None,
+    ant_url: Optional[str] = None,
+    codeql_url: Optional[str] = None,
+    exe_path: Optional[str] = None,
+    cwd: Optional[str] = None,
+    timeout_seconds: Optional[float] = 3600.0,
+) -> Dict[str, Any]:
+    """
+    一键安装环境：等价于命令行
+      ./codeql_n1ght -install [-jdk <url>] [-ant <url>] [-codeql <url>]
+    """
+    resolved_path = _resolve_exe_path(exe_path)
+    if not os.path.exists(resolved_path):
+        return {
+            "returncode": None,
+            "stdout": "",
+            "stderr": f"Executable not found: {resolved_path}",
+            "timeout": False,
+        }
+
+    args: List[str] = ["-install"]
+    if jdk_url:
+        args += ["-jdk", jdk_url]
+    if ant_url:
+        args += ["-ant", ant_url]
+    if codeql_url:
+        args += ["-codeql", codeql_url]
+
+    return await _run_subprocess([resolved_path, *args], cwd=cwd, timeout=timeout_seconds)
+
+
+@app.tool()
+async def create_database(
+    target: str,
+    decompiler: Optional[str] = None,  # procyon | fernflower
+    extra_src_dir: Optional[str] = None,  # -dir
+    deps: Optional[str] = None,  # none | all | None(进入交互TUI)
+    goroutine: bool = False,  # -goroutine
+    max_goroutines: Optional[int] = None,  # -max-goroutines N
+    threads: Optional[int] = None,  # -threads N
+    clean_cache: bool = False,  # -clean-cache
+    exe_path: Optional[str] = None,
+    cwd: Optional[str] = None,
+    timeout_seconds: Optional[float] = 72000.0,
+) -> Dict[str, Any]:
+    """
+    创建 CodeQL 数据库：等价命令
+      ./codeql_n1ght -database <JAR|WAR|ZIP> [-decompiler procyon|fernflower] [-dir <path>] [-deps none|all] 
+                     [-goroutine] [-max-goroutines N] [-threads N] [-clean-cache]
+    """
+    resolved_path = _resolve_exe_path(exe_path)
+    if not os.path.exists(resolved_path):
+        return {
+            "returncode": None,
+            "stdout": "",
+            "stderr": f"Executable not found: {resolved_path}",
+            "timeout": False,
+        }
+
+    args: List[str] = ["-database", target]
+
+    if decompiler:
+        dec = decompiler.lower().strip()
+        if dec not in {"procyon", "fernflower"}:
+            return {
+                "returncode": None,
+                "stdout": "",
+                "stderr": f"Invalid decompiler: {decompiler}. Expected 'procyon' or 'fernflower'",
+                "timeout": False,
+            }
+        args += ["-decompiler", dec]
+
+    if extra_src_dir:
+        args += ["-dir", extra_src_dir]
+
+    if deps:
+        d = deps.lower().strip()
+        if d not in {"none", "all"}:
+            return {
+                "returncode": None,
+                "stdout": "",
+                "stderr": f"Invalid deps: {deps}. Expected 'none' or 'all' or leave empty to use interactive TUI",
+                "timeout": False,
+            }
+        args += ["-deps", d]
+
+    # 新增：并行与缓存控制参数
+    if goroutine:
+        args += ["-goroutine"]
+    if isinstance(max_goroutines, int):
+        args += ["-max-goroutines", str(max_goroutines)]
+    if isinstance(threads, int):
+        args += ["-threads", str(threads)]
+    if clean_cache:
+        args += ["-clean-cache"]
+
+    return await _run_subprocess([resolved_path, *args], cwd=cwd, timeout=timeout_seconds)
+
+
+@app.tool()
+async def scan_database(
+    db: Optional[str] = None,
+    ql: Optional[str] = None,
+    goroutine: bool = False,
+    max_goroutines: Optional[int] = None,
+    threads: Optional[int] = None,
+    clean_cache: bool = False,
+    exe_path: Optional[str] = None,
+    cwd: Optional[str] = None,
+    timeout_seconds: Optional[float] = 720000.0,
+) -> Dict[str, Any]:
+    """
+    执行安全扫描：等价命令
+      ./codeql_n1ght -scan [-db <path>] [-ql <path>] [-goroutine] [-max-goroutines N] [-threads N] [-clean-cache]
+    """
+    resolved_path = _resolve_exe_path(exe_path)
+    if not os.path.exists(resolved_path):
+        return {
+            "returncode": None,
+            "stdout": "",
+            "stderr": f"Executable not found: {resolved_path}",
+            "timeout": False,
+        }
+
+    args: List[str] = ["-scan"]
+    if db:
+        args += ["-db", db]
+    if ql:
+        args += ["-ql", ql]
+    if goroutine:
+        args += ["-goroutine"]
+    if isinstance(max_goroutines, int):
+        args += ["-max-goroutines", str(max_goroutines)]
+    if isinstance(threads, int):
+        args += ["-threads", str(threads)]
+    if clean_cache:
+        args += ["-clean-cache"]
+
+    return await _run_subprocess([resolved_path, *args], cwd=cwd, timeout=timeout_seconds)
+
+
+def main():
+    # 以 STDIO 方式启动 MCP 服务
+    print("MCP server started in STDIO mode")
+    app.run(transport="stdio")
+
+if __name__ == "__main__":
+    main()

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/language.json

@@ -0,0 +1 @@
+python

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/package_name

@@ -0,0 +1 @@
+iflow-mcp_yezere-codeql_n1ght_mcp_server

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "iflow-mcp_yezere-codeql_n1ght_mcp_server"
+version = "0.1.0"
+description = "MCP server for CodeQL N1ght tool integration"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp>=1.1.0",
+]
+
+[project.scripts]
+codeql-n1ght-mcp = "codeql_n1ght_mcp_server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]

iflow_mcp_yezere_codeql_n1ght_mcp_server-0.1.0/requirements.txt

@@ -0,0 +1 @@
+mcp>=1.1.0