---
title: "FastMCP Artık MCPServer: Bir Python MCP Sunucusunu MCP SDK 2.x Sürümüne Taşıma Rehberi"
url: https://blog.edumints.com/fastmcp-artik-mcpserver-bir-python-mcp-sunucusunu-mcp-sdk-2x-dn9ee7yl
category: "AI Araçları"
date: 2026-09-14T07:10:21.472Z
publisher: Edumints Blog
lang: tr-TR
source_name: "dev.to"
source_url: https://dev.to/gde/fastmcp-is-now-mcpserver-migrating-a-python-mcp-server-to-the-mcp-sdk-2x-2nhj
---

# FastMCP Artık MCPServer: Bir Python MCP Sunucusunu MCP SDK 2.x Sürümüne Taşıma Rehberi

Bağımlılık güncellemeleri, özellikle paylaşılan ortamlarda çalışan sistemlerde beklenmedik kırılmalara yol açabilir. Bu rehber, bir Python MCP (Model Context Protocol) sunucusunun SDK 1.x (`FastMCP`) sürümünden 2.x (`MCPServer`) sürümüne adım adım nasıl taşınacağını açıklamaktadır. Örnek senaryoda, Cloud Run üzerinde barındırılan GPU özellikli bir sisteme Gemma 4 E2B modelinin dağıtımı ve vLLM yönetimini kolaylaştıran Python MCP araçlarının entegrasyonu ele alınmaktadır.

## Ne Bozuldu?

Depodaki kaynak kodlar değişmemiş olsa da temiz bir kurulumda (`fresh install`) sistem çalışmaz hale geldi. Projenin `requirements.txt` dosyasında `mcp` paketi sürüm sınırlaması olmadan yer aldığı için `pip install` doğrudan yeni 2.x sürümünü yükledi:

- `from mcp.server.fastmcp import FastMCP` çağrısı `ModuleNotFoundError: No module named 'mcp.server.fastmcp'` hatası üretti.
- SDK 2.x içinde bırakılan `fastmcp.py` dosyası, kullanıcıya FastMCP'nin `MCPServer` (`from mcp.server.mcpserver import MCPServer`) olarak yeniden adlandırıldığını veya `mcp<2` sürümünün sabitlenmesi gerektiğini bildiren net bir istisna fırlattı.
- Claude Code istemcisinde ise sunucu stdio el sıkışması tamamlanamadan kapandığı için yalnızca `Connection closed` hatası görüldü.

## Sürümü Sabitlemek mi, Göç Etmek mi?

Hata çıktısı iki temel çözüm yolu sunar:

- **Kod Değişikliği:** Sürümü sabitlemek (`pin`) kod değişikliği gerektirmez; `MCPServer`'a geçiş ise `import` ve sınıf adının güncellenmesini gerektirir.
- **Çözümün Konumu:** Sürüm sabitleme işlemi sunucuyu çalıştıran tüm Python ortamlarında uygulanmalıdır; göç işlemi doğrudan depoda çözülür.
- **Paylaşılan Sistem Python Ortamı:** Sanal ortam (`virtualenv`) bulunmayan paylaşılan sistemlerde `mcp<2` sabitlemesi makinedeki tüm projelerin sürümünü düşürür (`downgrade`); göç ise global ortama dokunmaz.
- **Gelecek Düzeltmeler:** Sabitleme v1 bakım hattı ile sınırlı kalırken, göç etmek projenin aktif geliştirilen ana hatta kalmasını sağlar.

## Bu Aşamada Nelere Sahip Olmalısınız?

Geçiş ve dağıtım sürecini yürütmek için 5 gereksinim:

- **Python 3.10 veya üzeri:** `mcp 2.x`, `Requires-Python >= 3.10` sürümünü zorunlu tutar.
- **Google Cloud SDK:** Oturum açılmış ve varsayılan uygulama kimlik bilgileri (ADC) tanımlanmış olmalıdır.
- **GCP Projesi:** İlgili bölgede (örneğin `us-east4`) Cloud Run GPU erişim izni bulunmalıdır.
- **GCS Bucket:** Model ağırlıklarını barındırmak için `project-bucket` adında bir depolama alanı.
- **Klonlanmış Depo:** İlgili Git deposu klonlanmış ve çalışma dizini olarak ayarlanmış olmalıdır.

## 2.x Sürümünde Neler Değişti?

Projelerin karşılaştığı başlıca 6 kritik API değişikliği:

- **FastMCP -> MCPServer:** `from mcp.server.fastmcp` kaldırıldı, `from mcp.server.mcpserver import MCPServer` kullanımına geçildi.
- **httpx -> httpx2:** `httpx` kütüphanesi yerine `httpx2` kütüphanesine geçiş yapıldı.
- **Senkron İşleyiciler (Worker Thread):** Senkron işleyiciler artık arka plan iş parçacığında çalıştığı için doğrudan `get_running_loop()` çağırmak istisna fırlatır.
- **camelCase -> snake_case:** `inputSchema` gibi model alanları Python standartlarına uyum için `input_schema` biçimine dönüştürüldü.
- **Kaynak URI Türü Değişimi:** Kaynak (`Resource`) URI yapıları artık `AnyUrl` yerine doğrudan `str` olarak tanımlanır.
- **Transport Parametreleri:** İletişim taşıma katmanı parametreleri ve yapılandırma arayüzü güncellendi.

Yazılım geliştirme açısından çıkarım: Bağımlılıkları sürüm kısıtı olmadan tanımlamak kırılganlıklara yol açar; paylaşılan ortamlarda bağımlılık çakışmalarını önlemek adına kütüphaneleri güncel protokollere adapte etmek en sağlıklı yaklaşımdır.

[[Orijinal kaynağa buradan ulaşabilirsiniz.](https://dev.to/gde/fastmcp-is-now-mcpserver-migrating-a-python-mcp-server-to-the-mcp-sdk-2x-2nhj)](https://dev.to/gde/fastmcp-is-now-mcpserver-migrating-a-python-mcp-server-to-the-mcp-sdk-2x-2nhj)

---

Bu konuyu derinlemesine öğrenmek isterseniz: [MCP Sunucusu Geliştirme](https://edumints.com/kesfet/mcp-model-context-protocol-ai-asistanlarini-aracla-bin4) modülüne göz atın.

---

**Kaynak:** [dev.to](https://dev.to/gde/fastmcp-is-now-mcpserver-migrating-a-python-mcp-server-to-the-mcp-sdk-2x-2nhj)
**Yayıncı:** [Edumints Blog](https://blog.edumints.com) · Alıntılarken bu URL'ye bağlantı verin: https://blog.edumints.com/fastmcp-artik-mcpserver-bir-python-mcp-sunucusunu-mcp-sdk-2x-dn9ee7yl