Initial commit

src/git/README.md

@@ -0,0 +1,97 @@
+# 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/example-servers/
+
+Pull requests welcome!