fmobey/mcp-server

MCP Node.js Sunucusu

Genel Bakış

MCP (Model Context Protocol), yapay zeka destekli geliştirme ortamlarına (örneğin Cursor AI gibi) özel araçlar entegre etmenizi sağlayan bir çerçevedir. Bu proje, Node.js kullanılarak geliştirilmiş basit bir MCP sunucusunu içerir.

Özellikler

• Sayısal İşlemler: İki sayıyı toplama fonksiyonu
• Ortam Değişkeni Yönetimi: API anahtarı gibi hassas bilgilerin güvenli bir şekilde yönetimi
• Giriş Doğrulama: Zod kütüphanesi ile şema doğrulama
• Standart G/Ç İletişimi: Geliştirme ortamlarıyla entegrasyon için StdioServerTransport kullanımı

Kurulum Gereksinimleri

• Node.js: Sürüm 20 veya üzeri
• npm: Node.js ile birlikte gelen paket yöneticisi
• Git: Versiyon kontrol sistemi (opsiyonel)

Kurulum Adımları

1. Projeyi İndirme

git clone <repository_url>
cd <repository_directory>

2. Bağımlılıkların Kurulumu

İki farklı yöntemle kurulum yapabilirsiniz:

A. Otomatik Kurulum

npm install

B. Manuel Kurulum

# Önce mevcut package.json'ı silin (isteğe bağlı)
npm install @modelcontextprotocol/sdk @coinpaprika/api-nodejs-client zod

Manuel kurulum yaptıysanız, package.json dosyasına ES Modules desteği için aşağıdaki satırı eklemeyi unutmayın:

{
  "type": "module"
}

Cursor AI ile Entegrasyon

Yapılandırma Dosyası Oluşturma

./cursor/mcp.json dosyası MCP sunucusunun yapılandırmasını içerir. Aşağıdaki yapıyı kullanarak kendi yapılandırmanızı oluşturabilirsiniz:

{
  "mcpServers": {
    "Furkan Metin OGUZ MCP Sunucusu": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-server.js"],
      "env": {
        "API_KEY": "sizin-api-anahtariniz"
      }
    }
  }
}

Yapılandırma Bileşenleri

• mcpServers: Sunucu yapılandırmalarını içeren ana nesne
• command: Node.js çalıştırılabilir dosyasının tam yolu
• args: MCP sunucu dosyasının tam yolu
• env: Ortam değişkenleri (API anahtarı gibi)

Otomatik Yapılandırma

Projenin kök dizininde aşağıdaki komutları çalıştırarak yapılandırmayı otomatikleştirebilirsiniz:

chmod +x ./scripts/update_config.sh
./scripts/update_config.sh

Kullanım Örnekleri

1. Sayı Toplama İşlemi

add 3 ve 5

2. API Anahtarı ekleme(Linux/Mac)

export API_KEY=abc-123456

Teknik Detaylar

Sunucu Yapısı

• MCP Sunucu Başlatma: McpServer sınıfı kullanılarak sunucu örneği oluşturulur
• İletişim: StdioServerTransport ile standart giriş/çıkış üzerinden iletişim sağlanır
• Araç Tanımlamaları:
  • add: İki sayıyı toplama işlemi
  • getApiKey: API anahtarı sorgulama

Güvenlik Önlemleri

• Hassas bilgiler (API anahtarları gibi) ortam değişkenlerinde saklanır
• Giriş doğrulama ile zararlı veri girişi engellenir
• Standart G/Ç kullanılarak güvenli iletişim sağlanır

Hata Ayıklama

Sık Karşılaşılan Sorunlar ve Çözümleri

1. Node.js Sürüm Hatası

   node -v # Sürümünüzü kontrol edin
   nvm install 20 # Gerekirse güncelleyin
   

2. Bağımlılık Hataları

   rm -rf node_modules
   npm install
   

3. Yapılandırma Sorunları

   • Node.js yolunun doğru olduğundan emin olun
   • mcp.json dosyasındaki yolları kontrol edin

Katkıda Bulunma

1. Fork yapın
2. Yeni bir branch oluşturun
3. Değişikliklerinizi commit edin
4. Pull request gönderin

Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için dosyasına bakın.

İletişim

Furkan Metin OGUZ

• GitHub: github.com/fmobey
• LinkedIn: linkedin.com/in/furkanmetinoguz

Sürüm Geçmişi

• v1.0.0 - İlk sürüm
  • Temel MCP sunucu yapısı
  • Toplama ve API anahtarı araçları