Portfolio of a .NET Software Engineer | Drilind Olluri

Drilind Olluri

Backend engineer with 4 years of experience building high-throughput .NET microservices on Kubernetes. I work with C#, Orleans, gRPC, Kafka, and distributed systems. Currently exploring MCP-powered AI agents for scheduling automation. Based in Prishtina, Kosovo.

Software Engineer, Specialized on backend most specifically on the .NET Framework


# GitMCP: Revolutionizing AI Code Understanding with GitHub Repository Context

As a software engineer specializing in scalable backend systems, I'm always on the lookout for tools that can enhance my development workflow. Recently, I discovered [GitMCP](https://gitmcp.io/), an incredible open-source project by [idosal](https://github.com/idosal) that's changing how AI assistants understand and work with code repositories.

## What is GitMCP?

GitMCP is a free, open-source Model Context Protocol (MCP) server that creates instant AI context for any GitHub repository. The concept is brilliantly simple: replace `github.com` with `gitmcp.io` in any repository URL, and you get an MCP server that your AI assistant can use to understand the project's context deeply.

### The Problem It Solves

When working with new packages or frameworks that AI models don't have extensive training data on, we often encounter:

- **Code hallucinations** - AI suggesting non-existent APIs or incorrect usage patterns
- **Outdated information** - AI referencing deprecated methods or old documentation
- **Lack of context** - AI not understanding project-specific conventions or architecture

GitMCP eliminates these issues by providing real-time access to the actual repository documentation and code.

## How GitMCP Works

The magic happens through the Model Context Protocol, which allows AI assistants to request additional context from external sources. Here's the workflow:

1. **You configure** GitMCP as an MCP server in your AI tool
2. **You ask questions** about documentation or code
3. **Your AI sends requests** to GitMCP (with your approval)
4. **GitMCP fetches** the relevant information from the GitHub repository
5. **Your AI receives** accurate, up-to-date information and provides grounded responses

### Supported Documentation Priority

GitMCP intelligently prioritizes documentation sources:

1. `llms.txt` - AI-optimized documentation
2. Project-specific documentation
3. `README.md` and other root documentation

## Setting Up GitMCP with Cursor

As someone who uses Cursor extensively for .NET development, I can attest to how seamlessly GitMCP integrates. Here's how to set it up:

### Step 1: Modify Your MCP Configuration

Navigate to your Cursor MCP configuration file (typically at `~/.cursor/mcp.json` on macOS/Linux or `%USERPROFILE%\.cursor\mcp.json` on Windows) and add your desired repositories:

```json
{
  "mcpServers": {
    "Orleans Framework": {
      "url": "https://gitmcp.io/dotnet/orleans"
    },
    "ASP.NET Core": {
      "url": "https://gitmcp.io/dotnet/aspnetcore"
    },
    "Entity Framework": {
      "url": "https://gitmcp.io/dotnet/efcore"
    },
    "Your Repository or the libray that you want to integrate": {
      "url": "https://gitmcp.io/yourusername/yourrepo"
    }
  }
}
```

### Step 2: Restart Cursor

After modifying the configuration, restart Cursor to load the new MCP servers.

### Step 3: Start Coding with Enhanced Context

Now when you ask questions about these frameworks, Cursor will have access to the latest documentation and can provide accurate, contextual responses.

## Real-World Use Cases

### 1. Learning New Frameworks

When I started working with Orleans Framework for distributed systems, GitMCP provided instant access to the latest documentation, helping me understand grain lifecycle management and clustering configurations without outdated information.

### 2. API Integration

Working with third-party APIs becomes much easier when the AI has access to the actual repository documentation, including examples and best practices.

### 3. Open Source Contributions

Before contributing to open-source projects, GitMCP helps understand the codebase structure, coding conventions, and contribution guidelines.

## The Universal Endpoint

One of GitMCP's most powerful features is the universal endpoint `gitmcp.io/docs`. This allows your AI to dynamically choose which GitHub repository to query based on your questions, without pre-configuring specific repositories.

## Tools Available Through GitMCP

GitMCP provides several powerful tools to AI assistants:

- **`fetch_documentation`** - Retrieves primary project documentation
- **`search_documentation`** - Searches through documentation with specific queries
- **`search_code`** - Searches through actual repository code
- **`fetch_url_content`** - Retrieves content from referenced links

## Privacy and Security

As someone who values privacy in development tools, I appreciate that GitMCP:

- Doesn't require authentication
- Doesn't store personal information
- Only accesses publicly available content
- Respects `robots.txt` directives
- Is open-source and can be self-hosted

## Shoutout to the Creator

Massive kudos to [idosal](https://github.com/idosal) for creating and open-sourcing this incredible tool. The [git-mcp repository](https://github.com/idosal/git-mcp) shows the thoughtful engineering behind this project, and the fact that it's freely available to the community demonstrates the best of open-source collaboration.

---

_Have you tried GitMCP in your development workflow? I'd love to hear about your experiences and how it's enhanced your coding process._


Discover how GitMCP transforms AI coding assistance by providing instant context from any GitHub repository, eliminating code hallucinations and enhancing development workflows.

Blog Posts

GitMCP: Revolutionizing AI Code Understanding with GitHub Repository Context