Başlarken

MCP'de ya da bu SDK'da yeni misiniz? Buradan başlayın. Bu sayfalar sizi sıfırdan çalışan, test edilmiş bir sunucuya götürür: SDK'yı kurun, ilk sunucunuzu yazın, onu gerçek bir host'a bağlayın ve bellek içi bir istemciyle test edin.

Kodu çalıştırma

Kod bloklarının tamamı doğrudan kopyalanıp kullanılabilir: hepsi eksiksiz, çalışan dosyalardır.

Takip etmek için bir bloğu server.py dosyasına yapıştırın ve MCP Inspector'da açın:

uv run mcp dev server.py

Kodu yazmanız (ya da kopyalamanız), düzenlemeniz ve yerelde çalıştırmanız ŞİDDETLE önerilir. Asıl meseleyi kendi editörünüzde kullanırken görürsünüz: ne kadar az kod yazdığınızı, otomatik tamamlamayı, daha hiçbir şeyi çalıştırmadan hataları yakalayan tür denetimlerini.

Tahmin yürütmeyeceksiniz

Bu belgelerdeki her örnek, SDK'nın kendi deposunda docs_src/ altında duran eksiksiz bir dosyadır ve her biri SDK'nın test paketi tarafından bellek içi bir istemci aracılığıyla çalıştırılır:

import pytest
from mcp import Client

from server import mcp


@pytest.mark.anyio
async def test_add() -> None:
    async with Client(mcp) as client:
        result = await client.call_tool("add", {"a": 1, "b": 2})
        assert result.structured_content == {"result": 3}

Alt süreç yok, port yok, aktarım yok. Client(mcp) sunucu nesnesine doğrudan bağlanır.

SDK'daki bir değişiklik bu sayfalardan birindeki örneği bozarsa, sayfadan önce CI kırmızıya döner. Burada okuduğunuz kod, çalışan kodun ta kendisidir.

Bunu Test etme sayfasında kendiniz de kullanacaksınız; kendi sunucularınızı da böyle test edersiniz.

Bundan sonra nereye

Bir sunucuyu çalıştırdıktan sonra bu belgelerin geri kalanı bir kurs değil, bir başvuru kaynağıdır. Her sayfa kendi başına ayakta durur; bu yüzden doğrudan ihtiyacınız olana atlayın:

• Bir sunucunun ne sunduğu (araçlar, kaynaklar, prompt'lar) Sunucular bölümünde.
• Kaydettiğiniz fonksiyonların içinde nelerin kullanılabildiği İşleyicinin içinde bölümünde.
• Sunucuyu istemcilerin önüne çıkarma (stdio, HTTP, mevcut FastAPI uygulamanız) Sunucunuzu çalıştırma bölümünde.
• Diğer tarafı, yani MCP sunucularını kullanan bir uygulamayı oluşturma İstemciler bölümünde.