xCodeAssist iPlat4J 知识库 MCP（npm 发布版）

这是一个基于 Node.js 的独立 MCP 服务，用来访问 iPlat4J 知识库。 该目录为“可发布到 npm 的版本”，不再内置 baseUrl 与 apiKey，只能通过环境变量配置。

内置数据集映射：

• jsp -> 694b33a3443f2098d53d818c
• vue -> 694b3559443f2098d53de13d

功能

• 基于官方 Node MCP SDK 的标准 stdio 服务
• 内置固定的 JSP / VUE datasetId
• 通过环境变量配置知识库服务地址和 API Key
• 不依赖本机 xCodeAssist 插件

运行要求

• Node.js 20 及以上

配置方式

必填环境变量：

• IPLAT4J_KB_BASE_URL：知识库服务地址，例如 https://kb.example.com
• IPLAT4J_KB_API_KEY：访问 API Key

可选环境变量：

• IPLAT4J_KB_MODE：默认模式，可选值 vue 或 jsp，默认 vue

启动（推荐）

npx -y @irailmetro/xcodeassist-kb-mcp

本地开发（可选）

cd <project_dir>
npm install
npx xcodeassist-kb-mcp-node

MCP 配置示例

参考 mcp.json.example。

{
  "mcpServers": {
    "iplat4j-kb": {
      "command": "npx",
      "args": [
        "-y",
        "@irailmetro/xcodeassist-kb-mcp"
      ],
      "env": {
        "IPLAT4J_KB_BASE_URL": "https://kb.example.com",
        "IPLAT4J_KB_API_KEY": "<your_api_key>",
        "IPLAT4J_KB_MODE": "vue"
      }
    }
  }
}

提供的工具

• iplat4j_kb_search: 按 mode=jsp|vue 检索对应知识库；如果不传 mode，使用 IPLAT4J_KB_MODE
• iplat4j_vue_kb_search: 只查 VUE 知识库，不受 IPLAT4J_KB_MODE 影响
• iplat4j_jsp_kb_search: 只查 JSP 知识库，不受 IPLAT4J_KB_MODE 影响
• iplat4j_kb_collection_list: 按 collectionId 拉取分片数据
• iplat4j_kb_config_info: 查看当前生效配置，不返回 API Key

说明

• 知识库接口鉴权优先使用标准写法 Authorization: Bearer <apiKey>。
• 如果后端返回未授权，代码会自动回退兼容旧的 Bearer<apiKey> 写法。
• 服务启动日志输出到 stderr，不会污染 MCP 的 stdio 协议流。