AI导哈

跨平台兼容性分析工具

MCP X-Platform 是一个跨平台兼容性分析工具，用于检测代码库中的平台特定API、文件路径问题、行尾不一致性、shell命令不兼容性和依赖问题。

  • by Atomic-Germ
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Atomic-Germ/mcp-x-platform

使用说明

MCP X平台

跨平台兼容性分析器MCP服务器，系统地识别特定于平台的代码模式、依赖关系和潜在的可移植性问题

概述

MCP X-Platform是一个模型上下文协议（MCP）服务器，旨在分析代码库以解决跨平台兼容性问题。它检测特定于平台的API、文件路径问题、行尾不一致、shell命令不兼容以及Windows、macOS和Linux之间的依赖关系问题。

主要特点

  • 🔍 平台API检测 -识别Windows、macOS、Linux和POSIX特定的API
  • 📁 文件路径分析 -检测分隔符问题、保留名称和区分大小写问题
  • 📝 线路结束检查 -查找CRLF与LF的不一致性
  • 🖥️ 壳牌命令分析 -识别特定于平台的shell命令和脚本
  • 📦 依赖兼容性 -分析平台特定包的依赖关系
  • 📊 综合报告 -生成详细的跨平台兼容性报告
  • 🔗 MCP集成 -与其他MCP工具无缝集成
  • ✅ 测试驱动 -使用TDD方法构建

安装

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

快速开始

作为MCP服务器

添加到您的MCP客户端配置中（例如，Claude Desktop）：

{
  "mcpServers": {
    "x-platform": {
      "command": "node",
      "args": ["/path/to/mcp-x-platform/dist/index.js"]
    }
  }
}

核心工具

工具 目的
detect_platform_apis 检测特定于平台的API调用
analyze_file_paths 分析文件路径的兼容性
analyze_line_endings 检查行尾一致性
analyze_shell_commands 分析shell命令兼容性
generate_compatibility_report 生成全面的报告

使用示例

检测平台API

{
  "tool": "detect_platform_apis",
  "arguments": {
    "path": "./src",
    "platforms": ["windows", "macos", "linux"]
  }
}

分析文件路径

{
  "tool": "analyze_file_paths",
  "arguments": {
    "path": "./src",
    "checkCaseSensitivity": true,
    "checkSeparators": true
  }
}

最佳实践

文件路径

// ✅ GOOD
import * as path from "path";
const filePath = path.join("src", "utils", "helper.js");

// ❌ BAD
const filePath = "src\\utils\\helper.js";

线条端点

# .gitattributes
* text=auto eol=lf
*.sh text eol=lf
*.{cmd,bat} text eol=crlf

shell命令

// ✅ GOOD - Cross-platform
import { rimraf } from "rimraf";
await rimraf("./temp");

// ❌ BAD - Platform-specific
exec("rm -rf ./temp");

发展

# Build
npm run build

# Test
npm test

# Watch mode
npm run build:watch

许可证

MIT许可证-请参阅 许可证 详细信息文件

为跨平台兼容性而构建❤️

相关 MCP