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"]
    }
  }
}

核心工具

使用示例

检测平台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许可证-请参阅 许可证 详细信息文件

______________________________________________________________________

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