快速差异比较

Installation & Usage

This project is a Python package with a Rust extension, so it requires a compilation step. The recommended way to install and run it is from a local clone of the repository.

Prerequisites

• Git
• Python (>= 3.10)
• Rust Toolchain
• uv (for Python environment and package management)

Running from Source

1. Clone the repository:

   git clone https://github.com/kweinmeister/fast-diff-mcp.git
   cd fast-diff-mcp
   

1. Install dependencies and compile the extension: This command sets up a virtual environment and installs the package in editable mode.

   uv pip install -e .
   

1. Run the server: From the root of the project directory, run:

   uv run server.py
   

Deploying to Google Cloud Run with Docker

This project is optimized for deployment to serverless platforms like Google Cloud Run using its included multi-stage Dockerfile.

The most direct way to deploy is with the gcloud CLI, which will build the container and deploy it in a single step.

Prerequisites:

• Google Cloud SDK installed and authenticated (gcloud auth login).
• A Google Cloud project with billing enabled and the Cloud Run API activated.

To deploy, run the following commands:

```bash

3. Deploy from source

gcloud will build the image and deploy it to Cloud Run

gcloud run deploy $SERVICE_NAME \ --allow-unauthenticated \ --region=$REGION \ --source . ```

After a few minutes, gcloud will provide a public URL for your service.

Configuration

To use this server with an MCP client, you must configure the client to run the server from your local clone of this repository. The commands below assume you are running them from the root of the cloned fast-diff-mcp directory.

Configure for Gemini CLI

Add the following to your ~/.gemini/settings.json file, replacing /path/to/fast-diff-mcp with the absolute path to where you cloned the repository.

<details> <summary>Using uv (from source)</summary>

{
  "mcpServers": {
    "diff": {
      "command": "uv",
      "args": ["run", "server.py"],
      "options": {
        "cwd": "/path/to/fast-diff-mcp"
      }
    }
  }
}

</details>

Configure for Claude.app

Add the following to your Claude settings, replacing /path/to/fast-diff-mcp with the absolute path to where you cloned the repository.

<details> <summary>Using uv (from source)</summary>

{
  "mcpServers": {
    "diff": {
      "command": "uv",
      "args": ["run", "server.py"],
      "options": {
        "cwd": "/path/to/fast-diff-mcp"
      }
    }
  }
}

</details>

Configure for VS Code

Add the following JSON block to your User Settings (JSON) file or a .vscode/mcp.json file in your workspace. Remember to replace /path/to/fast-diff-mcp with the correct absolute path.

Note that the mcp key is needed when using the mcp.json file.

<details> <summary>Using uv (from source)</summary>

{
  "mcp": {
    "servers": {
      "diff": {
        "command": "uv",
        "args": ["run", "server.py"],
        "options": {
          "cwd": "/path/to/fast-diff-mcp"
        }
      }
    }
  }
}

</details>

2. Configure gcloud to use your project

gcloud config set project $PROJECT_ID