# mcp-github-server

GitHub'in public REST API'sini kullanarak repo bilgisi sunan basit bir [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server'i. API key/token gerektirmez.

## Ne yapar?

Bu server, `mcp` SDK'sinin `FastMCP` siniflarini kullanarak iki tool sunar:

- **`list_repos(username="Mervecaliskann")`** — Verilen kullanicinin tum public repolarini (isim, yildiz sayisi, dil, url) listeler.
- **`get_repo_info(repo, username="Mervecaliskann")`** — Belirtilen reponun adi, tam adi, yildiz sayisi, programlama dili ve url'ini dondurur.

Claude gibi bir MCP client'a baglandiginda, bu tool'lar dogal dil ile ("repolarimi listele", "X reposunun yildiz sayisi nedir" gibi) cagrilabilir.

## Kurulum

```bash
git clone https://github.com/Mervecaliskann/mcp-github-server.git
cd mcp-github-server

python -m venv venv

# Windows
venv\Scripts\activate

# macOS / Linux
source venv/bin/activate

pip install -r requirements.txt
```

## Calistirma

```bash
python server.py
```

Server, stdio uzerinden MCP protokolu ile iletisim kurar; genellikle elle calistirilmaz, bir MCP client tarafindan baslatilir.

## MCP client (Claude Desktop / Claude Code) ile kullanim

Client'inizin MCP yapilandirmasina (orn. `.mcp.json` veya `claude_desktop_config.json`) asagidaki gibi bir girdi ekleyin; yollari kendi ortaminiza gore guncelleyin:

```json
{
  "mcpServers": {
    "github-server": {
      "command": "C:\\path\\to\\mcp-github-server\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\mcp-github-server\\server.py"]
    }
  }
}
```

## Gereksinimler

- Python 3.10+
- [`mcp`](https://pypi.org/project/mcp/) >= 1.2.0
- [`requests`](https://pypi.org/project/requests/) >= 2.31.0

Tum bagimliliklar `requirements.txt` icinde tanimlidir.