项目简介

'tatn_mcp-server-diff-python' 是一个实现了 Model Context Protocol (MCP) 的服务器,专注于提供文本差异比较功能。它利用 Python 的 'difflib' 库高效地生成 Unified diff 格式的文本差异,使得 LLM 客户端能够方便地获取和利用文本之间的差异信息。

主要功能点

  • get-unified-diff 工具: 接收两个字符串作为输入,返回它们之间差异的 Unified diff 格式文本。这个工具非常适合用于文本版本比较、代码审查等需要清晰展示文本变更的场景。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/MCP-Mirror/tatn_mcp-server-diff-python.git
    cd tatn_mcp-server-diff-python
  2. 安装依赖并构建:

    uv sync
    uv build

    'uv' 是仓库推荐的包管理工具,请确保已安装。如果未安装,请参考 uv installation guide.

服务器配置

要将此 MCP 服务器配置到 MCP 客户端(例如 Claude Desktop),您需要提供服务器的启动命令和参数。以下是配置示例,请根据您的实际环境调整路径。

配置示例 (JSON 格式):

"mcpServers": {
  "mcp-server-diff-python": {
    "command": "uvx",
    "args": [
      "mcp-server-diff-python"
    ]
  }
}

或者,如果您的 'uv' 命令不在系统 PATH 中,或者您希望更明确地指定服务器路径,可以使用以下配置:

"mcpServers": {
  "mcp-server-diff-python": {
    "command": "uv",
    "args": [
      "--directory",
      "path/to/mcp-server-diff-python",  // 将 "path/to/mcp-server-diff-python" 替换为您的仓库本地路径
      "run",
      "mcp-server-diff-python"
    ]
  }
}

配置参数说明:

  • '"mcp-server-diff-python"': 服务器名称,用于在客户端配置中标识该服务器。
  • '"command"': 启动服务器的命令。 'uvx' 会自动查找并运行 'mcp-server-diff-python' 入口点,或者使用 'uv run mcp-server-diff-python' 更显式地运行。
  • '"args"': 传递给启动命令的参数。 在第一个例子中,'uvx mcp-server-diff-python' 没有额外的参数。在第二个例子中,'--directory' 参数指定了服务器代码所在的目录。

请注意:

  • 您需要将 'path/to/mcp-server-diff-python' 替换为您实际克隆仓库的本地路径。
  • 确保 MCP 客户端配置文件(例如 Claude Desktop 的 'claude_desktop_config.json')中的 '"mcpServers"' 部分已正确配置。

基本使用方法

配置完成后,MCP 客户端应该能够检测到 'mcp-server-diff-python' 服务器提供的 'get-unified-diff' 工具。在客户端中,您可以调用此工具,并提供 'string_a' 和 'string_b' 两个参数(字符串类型)来比较文本差异。服务器将返回包含 Unified diff 格式文本的响应。

具体使用方式取决于您的 MCP 客户端的功能和界面。通常,您可以在客户端的工具调用或上下文菜单中找到已注册的 MCP 服务器工具,并填写相应的参数来使用 'get-unified-diff' 工具。

信息

分类

开发者工具