mcp-github-server

GitHub'in public REST API'sini kullanarak repo bilgisi sunan basit bir MCP (Model Context Protocol) 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

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

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:

{
  "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 >= 1.2.0
• requests >= 2.31.0

Tum bagimliliklar requirements.txt icinde tanimlidir.