Unified Diff Generator MCP Server

项目简介

'mcp-server-diff-typescript' 是一个实现了 Model Context Protocol (MCP) 的服务器,它使用 TypeScript 编写,专注于提供文本差异生成功能。该服务器通过 'get-unified-diff' 工具,允许客户端请求比较两个文本字符串,并以标准的 Unified Diff 格式获取它们之间的差异。这对于需要分析文本变更的应用场景非常有用。

主要功能点

  • 'get-unified-diff' 工具: 核心功能是生成两个文本字符串的 Unified Diff。
    • 接受 'oldString' 和 'newString' 两个参数,分别代表旧文本和新文本。
    • 使用高效的 'diff' 库进行差异检测,确保结果准确。
    • 差异结果以易于阅读的 Unified Diff 格式返回,包含上下文信息。

安装步骤

您可以选择全局安装或作为项目依赖安装此 MCP 服务器。

全局安装 (推荐)

npm install -g mcp-server-diff-typescript

全局安装后,您可以在任何地方通过命令 'mcp-server-diff-typescript' 启动服务器。

项目依赖安装

如果您希望将此服务器作为项目的一部分进行管理,可以将其安装为项目依赖:

npm install mcp-server-diff-typescript

安装后,您需要在项目脚本中或通过 'npx mcp-server-diff-typescript' 启动服务器。

本地构建安装 (开发者选项)

如果您需要修改代码或从源代码运行,可以进行本地构建:

git clone https://github.com/tatn/mcp-server-diff-typescript.git
cd mcp-server-diff-typescript
npm install
npm run build

构建完成后,您可以通过 'node build/index.js' 命令启动服务器。

服务器配置

要将 'mcp-server-diff-typescript' 服务器与 MCP 客户端连接,您需要在客户端的配置文件中添加服务器配置。以 Claude Desktop 为例,您需要在 'claude_desktop_config.json' 文件中配置 'mcpServers' 字段。

使用全局安装的服务器配置:

"mcpServers": {
  "diff-server": {  //  服务器名称,可以自定义,用于在客户端中引用
    "command": "npx", //  启动服务器的命令,这里使用 npx 运行全局安装的包
    "args": [
      "-y",
      "mcp-server-diff-typescript" //  要执行的包名,即 mcp-server-diff-typescript
    ]
  }
}

使用本地构建的服务器配置:

如果您选择本地构建并运行服务器,请使用以下配置,并将 '/path/to/mcp-server-diff-typescript' 替换为您的实际仓库路径:

"mcpServers": {
  "diff-server": {  // 服务器名称,可以自定义
    "command": "node", // 启动服务器的命令,这里使用 node 运行 JavaScript 文件
    "args": [
      "/path/to/mcp-server-diff-typescript/build/index.js" // 服务器入口文件路径,指向构建后的 index.js 文件
    ]
  }
}

基本使用方法

配置完成后,MCP 客户端将能够检测到 'diff-server'。客户端可以向服务器发送符合 MCP 协议的请求,调用 'get-unified-diff' 工具,并提供 'oldString' 和 'newString' 参数来获取文本差异结果。服务器将返回包含 Unified Diff 格式文本内容的响应。

信息

分类

开发者工具