sca-ai-mcp-kb

SCA MCP Server Tools - Knowledge Base

这是一个 npm wrapper 包，将 Java JAR 形式的 MCP Server 包装为可以通过 npx 直接运行的 Node.js CLI 工具。

前置条件

• Node.js >= 18
• JDK >= 21

快速开始

方式一：通过环境变量指向已有 JAR（推荐用于开发）

# 设置 Java 路径
set SCA_MCP_JAVA_HOME=C:\developer\Java\jdk-21

# 设置 JAR 路径
set SCA_MCP_JAR=C:\softsafe-sca\codes\sca-ai\sca-ai-hub\sca-ai-mcp-kb\target\sca-ai-mcp-kb.jar

# 运行
npx sca-ai-mcp-kb

方式二：发布到 npm registry 后直接使用

npx sca-ai-mcp-kb

MCP 客户端配置

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "sca-ai-mcp-kb": {
      "command": "npx",
      "args": ["sca-ai-mcp-kb"],
      "env": {
        "SCA_MCP_JAVA_HOME": "C:\\developer\\Java\\jdk-21"
      }
    }
  }
}

全局安装后使用

npm install -g sca-ai-mcp-kb

然后配置：

{
  "mcpServers": {
    "sca-ai-mcp-kb": {
      "command": "sca-ai-mcp-kb",
      "env": {
        "SCA_MCP_JAVA_HOME": "C:\\developer\\Java\\jdk-21"
      }
    }
  }
}

环境变量

| 变量名 | 说明 | 示例 | |--------|------|------| | SCA_MCP_JAVA_HOME | JDK 安装路径（优先级最高） | C:\developer\Java\jdk-21 | | SCA_MCP_JAVA | java 可执行文件的完整路径 | C:\developer\Java\jdk-21\bin\java.exe | | JAVA_HOME | JDK 安装路径（兜底） | C:\developer\Java\jdk-21 | | SCA_MCP_JAR | JAR 文件完整路径 | ./target/sca-ai-mcp-kb.jar |

传递 Spring Boot 参数

npx sca-ai-mcp-kb -- --spring.profiles.active=prod --server.port=8080

发布流程

# 1. 构建 JAR
cd sca-ai-mcp-kb
mvn clean package -DskipTests

# 2. 复制 JAR 到 npm-wrapper/jar/
cp target/sca-ai-mcp-kb.jar npm-wrapper/jar/

# 3. 发布 npm 包
cd npm-wrapper
npm publish

目录结构

npm-wrapper/
├── bin/
│   └── sca-ai-mcp-kb.js   # 启动脚本
├── jar/
│   └── sca-ai-mcp-kb.jar  # 打包的 JAR（发布时放入）
├── package.json
├── README.md
└── .npmignore