GitHub MCP Server

Model Context Protocol (MCP) sunucusu: Cursor ve benzeri istemcilerden GitHub REST API’ye (Octokit) güvenli köprü. Tek bir depo (GITHUB_OWNER / GITHUB_REPO) için issue, milestone, proje ve label işlemlerini MCP tool olarak sunar.

Özellikler

• Issue: listele, getir, oluştur, güncelle

• Milestone: listele, oluştur, güncelle

• Project ve label listeleri

• stdio transport — Cursor MCP yapılandırması ile yerel node dist/index.js çalıştırılır

Related MCP server: Conduit

Gereksinimler

• Node.js 18+ (TypeScript 5.x ile derleme)

• GitHub Personal Access Token (klasik veya fine-grained; repo/issue/project izinleri ihtiyaca göre)

Kurulum

git clone https://github.com/eemredemirci/github-mcp-server.git
cd github-mcp-server
npm install
npm run build

Ortam değişkenleri

Proje kökünde .env:

GITHUB_TOKEN=ghp_xxxxxxxx
GITHUB_OWNER=eemredemirci
GITHUB_REPO=your-repo-name

GITHUB_TOKEN asla depoya commit edilmemelidir.

Çalıştırma

npm start

Bu komut dist/index.js dosyasını çalıştırır (package.json → "start": "node dist/index.js").

Cursor’a ekleme

1. Cursor → Settings → MCP (veya proje .cursor/mcp.json)

2. stdio sunucusu: node + tam yol ...\github-mcp-server\dist\index.js

3. Ortam değişkenlerini Cursor MCP tanımında veya .env ile sağlayın (Cursor sürümüne göre değişir).

Sunulan araçlar (tools)

Teknik yığın

• TypeScript, ES modules

• Octokit (GitHub REST)

• @modelcontextprotocol/sdk

• Zod şema doğrulama

• dotenv

Örnek .cursor/mcp.json

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}",
        "GITHUB_OWNER": "your-org-or-user",
        "GITHUB_REPO": "your-repo"
      }
    }
  }
}

Yolları kendi makinenize göre düzenleyin.

Lisans

ISC — package.json ile uyumlu.

İletişim

• GitHub: @eemredemirci