context7/docs/README.tr.md

Context7 MCP - Herhangi Bir Prompt İçin Güncel Kod Belgeleri

❌ Context7 Olmadan

LLM'ler, kullandığınız kütüphaneler hakkında güncel olmayan veya genel bilgilere güvenir. Karşılaştığınız sorunlar:

• ❌ Kod örnekleri eskidir ve bir yıllık eğitim verilerine dayanır
• ❌ Halüsinasyon yapılan API'ler gerçekte mevcut değildir
• ❌ Eski paket sürümleri için genel cevaplar alırsınız

✅ Context7 İle

Context7 MCP, güncel ve sürüme özel belgeleri ve kod örneklerini doğrudan kaynağından çeker ve doğrudan prompt'unuza yerleştirir.

Cursor'da prompt'unuza use context7 ekleyin:

Next.js ile app router kullanan basit bir proje oluştur. use context7

PostgreSQL kimlik bilgileriyle şehir değeri "" olan satırları silmek için bir betik oluştur. use context7

Context7, güncel kod örneklerini ve belgelerini doğrudan LLM'inizin içeriğine getirir.

• 1️⃣ Prompt'unuzu doğal bir şekilde yazın
• 2️⃣ LLM'e use context7 kullanmasını söyleyin
• 3️⃣ Çalışan kod cevapları alın

Sekme değiştirme, var olmayan halüsinasyon API'ler, güncel olmayan kod üretimleri yok.

🛠️ Başlangıç

Gereksinimler

• Node.js >= v18.0.0
• Cursor, Windsurf, Claude Desktop veya başka bir MCP İstemcisi

Smithery aracılığıyla kurulum

Context7 MCP Server'ı Claude Desktop için Smithery aracılığıyla otomatik olarak kurmak için:

npx -y @smithery/cli install @upstash/context7-mcp --client claude

Cursor'da Kurulum

Şu yolu izleyin: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Aşağıdaki yapılandırmayı Cursor ~/.cursor/mcp.json dosyanıza yapıştırmanız önerilen yaklaşımdır. Ayrıca, proje klasörünüzde .cursor/mcp.json oluşturarak belirli bir projeye de kurabilirsiniz. Daha fazla bilgi için Cursor MCP belgelerine bakabilirsiniz.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Alternatif: Bun Kullanın

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Alternatif: Deno Kullanın

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": ["run", "--allow-net", "npm:@upstash/context7-mcp"]
    }
  }
}

Windsurf'te Kurulum

Bunu Windsurf MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için Windsurf MCP belgelerine bakabilirsiniz.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

VS Code'da Kurulum

Bunu VS Code MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için VS Code MCP belgelerine bakabilirsiniz.

{
  "servers": {
    "Context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Zed'de Kurulum

Zed Uzantıları aracılığıyla kurulabilir veya Zed settings.json dosyanıza ekleyebilirsiniz. Daha fazla bilgi için Zed Context Server belgelerine bakabilirsiniz.

{
  "context_servers": {
    "Context7": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp@latest"]
      },
      "settings": {}
    }
  }
}

Claude Code'da Kurulum

Bu komutu çalıştırın. Daha fazla bilgi için Claude Code MCP belgelerine bakabilirsiniz.

claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

Claude Desktop'ta Kurulum

Bunu Claude Desktop claude_desktop_config.json dosyanıza ekleyin. Daha fazla bilgi için Claude Desktop MCP belgelerine bakabilirsiniz.

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Docker Kullanımı

MCP sunucusunu bir Docker konteynerinde çalıştırmayı tercih ederseniz:

1. Docker Görüntüsü Oluşturun:

   Önce, proje kökünde (veya tercih ettiğiniz herhangi bir yerde) bir Dockerfile oluşturun:

   Dockerfile içeriğini görmek için tıklayın

   FROM node:18-alpine
   
   WORKDIR /app
   
   # En son sürümü global olarak yükleyin
   RUN npm install -g @upstash/context7-mcp@latest
   
   # Gerekirse varsayılan portu açın (isteğe bağlı, MCP istemci etkileşimine bağlıdır)
   # EXPOSE 3000
   
   # Sunucuyu çalıştırmak için varsayılan komut
   CMD ["context7-mcp"]
   

   Ardından, bir etiket (örneğin, context7-mcp) kullanarak görüntüyü oluşturun. Docker Desktop'un (veya Docker daemon'un) çalıştığından emin olun. Dockerfile'ı kaydettiğiniz dizinde aşağıdaki komutu çalıştırın:

   docker build -t context7-mcp .
   

2. MCP İstemcinizi Yapılandırın:

   MCP istemcinizin yapılandırmasını Docker komutunu kullanacak şekilde güncelleyin.

   cline_mcp_settings.json için örnek:

   {
     "mcpServers": {
       "Сontext7": {
         "autoApprove": [],
         "disabled": false,
         "timeout": 60,
         "command": "docker",
         "args": ["run", "-i", "--rm", "context7-mcp"],
         "transportType": "stdio"
       }
     }
   }
   

   Not: Bu bir örnek yapılandırmadır. Yapıyı uyarlamak için MCP istemcinize (Cursor, VS Code vb.) özel örneklere bakın (örneğin, mcpServers ve servers farkı). Ayrıca, args içindeki görüntü adının docker build komutu sırasında kullanılan etiketle eşleştiğinden emin olun.

Çevre Değişkenleri

• DEFAULT_MINIMUM_TOKENS: Belge alımı için minimum token sayısını ayarlayın (varsayılan: 10000).

Örnekler:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"],
      "env": {
        "DEFAULT_MINIMUM_TOKENS": "10000"
      }
    }
  }
}

Kullanılabilir Araçlar

• resolve-library-id: Genel bir kütüphane adını Context7 uyumlu bir kütüphane ID'sine dönüştürür.
  • libraryName (gerekli)
• get-library-docs: Context7 uyumlu bir kütüphane ID'si kullanarak bir kütüphane için belgeleri getirir.
  • context7CompatibleLibraryID (gerekli)
  • topic (isteğe bağlı): Belgeleri belirli bir konuya odaklayın (örn. "routing", "hooks")
  • tokens (isteğe bağlı, varsayılan 10000): Döndürülecek maksimum token sayısı. Yapılandırılmış DEFAULT_MINIMUM_TOKENS değerinden veya varsayılan 10000 değerinden düşük değerler otomatik olarak o değere yükseltilir.

Geliştirme

Projeyi klonlayın ve bağımlılıkları yükleyin:

bun i

Derleyin:

bun run build

Yerel Yapılandırma Örneği

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}

MCP Inspector ile Test Etme

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest

Sorun Giderme

ERR_MODULE_NOT_FOUND

Bu hatayı görürseniz, npx yerine bunx kullanmayı deneyin.

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Bu, özellikle npx'in paketleri düzgün şekilde yüklemediği veya çözemediği ortamlarda modül çözümleme sorunlarını genellikle çözer.

ESM Çözümleme Sorunları

Error: Cannot find module 'uriTemplate.js' gibi bir hatayla karşılaşırsanız, --experimental-vm-modules bayrağıyla çalıştırmayı deneyin:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
    }
  }
}

MCP İstemci Hataları

1. Paket adından @latest ifadesini kaldırmayı deneyin.

2. Alternatif olarak bunx kullanmayı deneyin.

3. Alternatif olarak deno kullanmayı deneyin.

4. npx ile yerel fetch desteğine sahip olmak için Node v18 veya daha yüksek bir sürüm kullandığınızdan emin olun.

Sorumluluk Reddi

Context7 projeleri topluluk katkılıdır ve yüksek kaliteyi korumaya çalışsak da, tüm kütüphane belgelerinin doğruluğunu, eksiksizliğini veya güvenliğini garanti edemeyiz. Context7'de listelenen projeler, Context7 tarafından değil, ilgili sahipleri tarafından geliştirilmekte ve sürdürülmektedir. Şüpheli, uygunsuz veya potansiyel olarak zararlı içerikle karşılaşırsanız, lütfen bizi hemen bilgilendirmek için proje sayfasındaki "Bildir" düğmesini kullanın. Tüm bildirimleri ciddiye alıyoruz ve platformumuzun bütünlüğünü ve güvenliğini korumak için işaretlenen içeriği hızla inceleyeceğiz. Context7'yi kullanarak, bunu kendi takdirinizle ve riskinizle yaptığınızı kabul etmiş olursunuz.

Context7 Medyada

• Better Stack: "Ücretsiz Araç Cursor'u 10 Kat Daha Akıllı Yapıyor"
• Cole Medin: "Bu, Tartışmasız AI Kodlama Asistanları İçin EN İYİ MCP Sunucusudur"
• Income stream surfers: "Context7 + SequentialThinking MCP'leri: Bu AGI mi?"
• Julian Goldie SEO: "Context7: Yeni MCP AI Aracı Güncellemesi"
• JeredBlu: "Context 7 MCP: Belgeleri Anında Alın + VS Code Kurulumu"
• Income stream surfers: "Context7: AI Kodlamayı DEĞİŞTİRECEK Yeni MCP Sunucusu"
• AICodeKing: "Context7 + Cline & RooCode: Bu MCP Sunucusu CLINE'ı 100 KAT DAHA ETKİLİ YAPIYOR!"
• Sean Kochel: "Vibe Kodlama İhtişamı İçin 5 MCP Sunucusu (Tak ve Çalıştır)"

Yıldız Geçmişi

Lisans

MIT