mcp-git


Namemcp-git JSON
Version 0.2.0 PyPI version JSON
download
home_pageNone
SummaryA Model Context Protocol server providing tools to read, search, and manipulate Git repositories programmatically via LLMs
upload_time2024-11-20 14:32:22
maintainerNone
docs_urlNone
authorAnthropic, PBC.
requires_python>=3.10
licenseMIT
keywords automation git llm mcp
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # mcp-git

A Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.

## Available Tools

- `git_read_file`: Read contents of a file at a specific Git reference
- `git_list_files`: List all files in a repository or subdirectory
- `git_file_history`: Get commit history for a specific file
- `git_commit`: Create Git commits with messages and specified files
- `git_search_code`: Search repository content with pattern matching
- `git_get_diff`: View diffs between Git references
- `git_get_repo_structure`: View repository file structure
- `git_list_repos`: List available Git repositories

## Installation

### Using uv

When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-git*.

### Using PIP

Alternatively you can install `mcp-git` via pip:

```
pip install mcp-git
```

After installation, you can run it as a script using:

```
python -m mcp_git
```

## Configuration
### Configure for Zed

Add to your Zed settings.json:

```json
"experimental.context_servers": {
  "servers": [
    {
      "id": "mcp-git",
      "executable": "uvx",
      "args": ["mcp-git"]
    }
  ]
},
```

Alternatively, if using pip installation:

```json
"experimental.context_servers": {
  "servers": [
    {
      "id": "mcp-git",
      "executable": "python",
      "args": ["-m", "mcp_git"]
    }
  ]
},
```

### Configure for Claude.app

Add to your Claude settings:

```json
"mcpServers": {
  "mcp-git": {
    "command": "uvx",
    "args": ["mcp-git"]
  }
}
```

Alternatively, if using pip installation:

```json
"mcpServers": {
  "mcp-git": {
    "command": "python",
    "args": ["-m", "mcp_git"]
  }
}
```

## Contributing

For examples of other MCP servers and implementation patterns, see:
https://github.com/modelcontextprotocol/servers/

Pull requests welcome!

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mcp-git",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "David Soria Parra <davidsp@anthropic.com>",
    "keywords": "automation, git, llm, mcp",
    "author": "Anthropic, PBC.",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/44/0c/da2b2e7ccbef0faa7c817a17063c8bb048efd1b8bd28c6642067598fb3d7/mcp_git-0.2.0.tar.gz",
    "platform": null,
    "description": "# mcp-git\n\nA Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.\n\n## Available Tools\n\n- `git_read_file`: Read contents of a file at a specific Git reference\n- `git_list_files`: List all files in a repository or subdirectory\n- `git_file_history`: Get commit history for a specific file\n- `git_commit`: Create Git commits with messages and specified files\n- `git_search_code`: Search repository content with pattern matching\n- `git_get_diff`: View diffs between Git references\n- `git_get_repo_structure`: View repository file structure\n- `git_list_repos`: List available Git repositories\n\n## Installation\n\n### Using uv\n\nWhen using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will\nuse [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-git*.\n\n### Using PIP\n\nAlternatively you can install `mcp-git` via pip:\n\n```\npip install mcp-git\n```\n\nAfter installation, you can run it as a script using:\n\n```\npython -m mcp_git\n```\n\n## Configuration\n### Configure for Zed\n\nAdd to your Zed settings.json:\n\n```json\n\"experimental.context_servers\": {\n  \"servers\": [\n    {\n      \"id\": \"mcp-git\",\n      \"executable\": \"uvx\",\n      \"args\": [\"mcp-git\"]\n    }\n  ]\n},\n```\n\nAlternatively, if using pip installation:\n\n```json\n\"experimental.context_servers\": {\n  \"servers\": [\n    {\n      \"id\": \"mcp-git\",\n      \"executable\": \"python\",\n      \"args\": [\"-m\", \"mcp_git\"]\n    }\n  ]\n},\n```\n\n### Configure for Claude.app\n\nAdd to your Claude settings:\n\n```json\n\"mcpServers\": {\n  \"mcp-git\": {\n    \"command\": \"uvx\",\n    \"args\": [\"mcp-git\"]\n  }\n}\n```\n\nAlternatively, if using pip installation:\n\n```json\n\"mcpServers\": {\n  \"mcp-git\": {\n    \"command\": \"python\",\n    \"args\": [\"-m\", \"mcp_git\"]\n  }\n}\n```\n\n## Contributing\n\nFor examples of other MCP servers and implementation patterns, see:\nhttps://github.com/modelcontextprotocol/servers/\n\nPull requests welcome!\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A Model Context Protocol server providing tools to read, search, and manipulate Git repositories programmatically via LLMs",
    "version": "0.2.0",
    "project_urls": null,
    "split_keywords": [
        "automation",
        " git",
        " llm",
        " mcp"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "23b1d39d075de13fed4851832d5ce39e739d0caff7a1cd460604d71bb2cf4116",
                "md5": "76078c9f939ebe0ac191c2ad9fdbe58d",
                "sha256": "aa4a3ea51a21b4d7f8c363db20a676409cd07b1533f330840d93d2c75df32dbc"
            },
            "downloads": -1,
            "filename": "mcp_git-0.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "76078c9f939ebe0ac191c2ad9fdbe58d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 7329,
            "upload_time": "2024-11-20T14:32:21",
            "upload_time_iso_8601": "2024-11-20T14:32:21.394552Z",
            "url": "https://files.pythonhosted.org/packages/23/b1/d39d075de13fed4851832d5ce39e739d0caff7a1cd460604d71bb2cf4116/mcp_git-0.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "440cda2b2e7ccbef0faa7c817a17063c8bb048efd1b8bd28c6642067598fb3d7",
                "md5": "aca4c21ad5c2939a222527cb99c174f0",
                "sha256": "d8723f246300db1f537627c1c608d1c8f5d8077341c739a0a973e2c572b46703"
            },
            "downloads": -1,
            "filename": "mcp_git-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "aca4c21ad5c2939a222527cb99c174f0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 19119,
            "upload_time": "2024-11-20T14:32:22",
            "upload_time_iso_8601": "2024-11-20T14:32:22.430401Z",
            "url": "https://files.pythonhosted.org/packages/44/0c/da2b2e7ccbef0faa7c817a17063c8bb048efd1b8bd28c6642067598fb3d7/mcp_git-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-20 14:32:22",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "mcp-git"
}
        
Elapsed time: 2.84494s