feat: implement MCP server

.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: ["3.8", "3.13"]
+        python-version: ["3.10", "3.13"]
         include:
           - os: ubuntu-latest
             python-version: "3.13"
@@ -43,7 +43,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          python -m pip install ".[dev,server]"
+          python -m pip install ".[dev,server,mcp]"
 
       - name: Cache pytest results
         uses: actions/cache@v4

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [Unreleased]
+
+### Features
+
+* **mcp:** Add Model Context Protocol (MCP) server support
+  - New `--mcp` CLI option to start MCP server
+  - `ingest_repository` tool for LLM integration
+  - Full MCP protocol compliance with stdio transport
+  - Enhanced MCP client examples for stdio transport
+
 ## [0.3.1](https://github.com/coderamp-labs/gitingest/compare/v0.3.0...v0.3.1) (2025-07-31)
 
 

README.md

@@ -51,6 +51,7 @@ You can also replace `hub` with `ingest` in any GitHub URL to access the corresp
   - Token count
 - **CLI tool**: Run it as a shell command
 - **Python package**: Import it in your code
+- **MCP Server**: Model Context Protocol server for LLM integration
 
 ## 📚 Requirements
 
@@ -74,6 +75,12 @@ pip install gitingest[server]
 
 to include server dependencies for self-hosting.
 
+For MCP (Model Context Protocol) support:
+
+```bash
+pip install gitingest[mcp]
+```
+
 However, it might be a good idea to use `pipx` to install it.
 You can install `pipx` using your preferred package manager.
 
@@ -150,6 +157,47 @@ See more options and usage details with:
 gitingest --help
 ```
 
+## 🤖 MCP (Model Context Protocol) Server
+
+Gitingest includes an MCP server that allows LLMs to directly access repository analysis capabilities through the Model Context Protocol.
+
+### Starting the MCP Server
+
+```bash
+# Start the MCP server with stdio transport
+python -m mcp_server
+```
+
+### Available Tools
+
+The MCP server provides the following tools:
+
+- **`ingest_repository`**: Ingest a Git repository or local directory and return a structured digest
+
+### Example MCP Client
+
+See `examples/mcp_client_example.py` for a complete example of how to use the MCP server.
+
+### Configuration
+
+Use the provided `examples/mcp-config.json` to configure the MCP server in your MCP client:
+
+#### Stdio Transport (Default)
+
+```json
+{
+  "mcpServers": {
+    "gitingest": {
+      "command": "python",
+      "args": ["-m", "mcp_server"],
+      "env": {
+        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}
+```
+
 ## 🐍 Python package usage
 
 ```python