</picture>

[!IMPORTANT] :test_tube: Bu proje deneyseldir ve breaking changes'a konu olabilir.

Massive.com MCP Server

Tam Massive.com finansal veri API'sine LLM dostu bir arayüzle erişim sağlayan Model Context Protocol (MCP) sunucusu.

Endpoint başına bir tool sunmak yerine, bu sunucu LLM'ye tam Massive.com API yüzeyini kaplayan üç composable tool sunar — search, call ve query. Veriler bir bellek içi SQLite veritabanında saklanabilir ve yerleşik finansal fonksiyonlarla zenginleştirilir.

Araçlar (Tools)

Yerleşik Fonksiyonlar

Fonksiyonlar call_api ve query_data'daki apply parametresi aracılığıyla API sonuçlarına veya sorgu çıktısına uygulanabilir. Bunları keşfetmek için search_endpoints'i scope="functions" ile kullanın.

Veri Kapsamı

Sunucu, başlangıçta llms.txt dosyasından tüm Massive.com API endpoint'lerini dinamik olarak indeksler, böylece API ile otomatik olarak senkronize kalır. Kapsam aşağıdakileri içerir:

• Hisse senedi, opsiyon, forex, kripto ve vadeli işlem agregasyonları
• Gerçek zamanlı ve geçmiş işlemler ve alıntılar
• Pazar anlık görüntüleri, kazananlar/kaybedenler
• Ticker detayları ve referans verileri
• Temettüler, bölünmeler, IPO'lar
• Finansal temel veriler
• Analist derecelendirmeleri ve haberler (Benzinga)
• Hazine getirileri, enflasyon verileri
• Pazar durumu ve tatiller

Kurulum

Ön Koşullar

• Python 3.12+
• Bir Massive.com API anahtarı
  
• Astral UV (v0.4.0+)

Claude Code

İlk olarak Claude Code'u yükleyin

npm install -g @anthropic-ai/claude-code

MCP sunucusunu yükleyin, ardından Claude Code'a kaydedin:

# Sunucuyu yükleyin (tek seferlik — bağımlılıkları önceden indir)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"

# Claude Code'a kaydedin
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

Daha sonra yeni bir sürüme yükseltmek için:

uv tool upgrade mcp_massive

[!NOTE] uvx veya uv run --with'den yükseltiliyor musunuz? Önceki sürümler uvx --from ... mcp_massive veya uv run --with komutlarını öneriyordu. Bu komutlar her soğuk başlangıçta bağımlılıkları indirir ve sunucunun Claude'un 30 saniyelik bağlantı zaman aşımını aşmasına neden olabilir. Yukarıda gösterildiği gibi uv tool install'a geçin — bağımlılıkları bir kez indirir ve bundan sonra anında başlar.

Bu komut, geçerli projenizde MCP sunucusunu yükleyecektir. Bunu küresel olarak yüklemek istiyorsanız, komutu -s <scope> bayrağı ile çalıştırabilirsiniz. Daha fazla seçenek için claude mcp add --help'e bakın.

Claude Code'u başlatmak için terminalinizde claude komutunu çalıştırın.

• İlk kez kullanıyorsanız, kimlik doğrulaması için kurulum istemlerini takip edin

Ayrıca MCP sunucusu Claude Desktop için zaten yüklüyse claude mcp add-from-claude-desktop komutunu çalıştırabilirsiniz.

Claude Desktop

1. İlk kurulumu tamamlamak ve yapılandırma dosyanızı bulmak için Claude Desktop MCP kurulum talimatlarını izleyin.
2. Sunucuyu yükleyin:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"

3. Yüklü binary yolunu bulun:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. Sunucuyu Claude Desktop konfigürasyon dosyanıza ekleyin. <path_to_mcp_massive>'i önceki adımdan çıktısıyla değiştirin ve kalan alanları doldurun.

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

Yapılandırma

Ortam Değişkenleri

İletim (Transport)

Varsayılan olarak STDIO iletimi kullanılır. İletim, --transport CLI argümanı veya MCP_TRANSPORT ortam değişkeni ile ayarlanabilir (CLI argümanı önceliklidir).

# CLI argümanı
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Ortam değişkeni
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

Kullanım Örnekleri

Entegre edildiğinde, Claude'u Massive.com verilerine erişmesi için istemlendirebilirsiniz:

AAPL hissesinin en son fiyatını al
MSFT'nin dün ticaret hacmini göster
Bugün hisse senedi piyasasındaki en büyük kazananlar nelerdi?
BTC-USD için en son kripto pazar verilerini al
Son 3 ay boyunca AAPL kapanış fiyatları için 20 günlük SMA hesapla
Bu opsiyon sözleşmeleri için Black-Scholes delta'sını hesapla

Geliştirme

Yerel Olarak Çalıştırma

Ön Koşullar bölümünde yüklü olduğundan emin olun.

# Bağımlılıkları senkronize et
uv sync

# Sunucuyu çalıştır
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Hata Ayıklama

Hata ayıklama ve test için MCP Inspector'u kullanmanızı öneriz:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

Bu, MCP sunucunuzla doğrudan etkileşim kurabileceğiniz ve her tool için giriş/çıkışı görebileceğiniz bir tarayıcı arayüzü başlatacaktır.

Tarayıcı UI'sinde STDIO iletim türünü uv komutu ve run mcp_massive argümanları ile seçin.

Kod Linting

Bu proje, yaygın geliştirme görevleri için just kullanır. Bir PR göndermeden önce kodunuzu linting etmek için:

just lint

Bu, ruff format ve ruff check --fix komutlarını çalıştırarak kodunuzu otomatik olarak biçimlendirecek ve linting sorunlarını düzeltecektir.

Bağlantılar

• Massive.com Dokumentasyonu
• Model Context Protocol
• MCP Python SDK

Gizlilik Politikası

Bu MCP sunucusu, pazar verilerini almak için Massive.com'un API'si ile etkileşime girer. Tüm veri istekleri Massive.com'un gizlilik politikası ve hizmet şartlarına tabidir.

• Massive.com Gizlilik Politikası: https://massive.com/legal/privacy
• Veri İşleme: Bu sunucu hiçbir kullanıcı verisi depolamaz veya önbelleğe almaz. Tüm istekler doğrudan Massive.com'un API'sine yönlendirilir.
• API Anahtarı: Massive.com API anahtarınız yalnızca API'lerine karşı istekleri doğrulamak için kullanılır.
• User-Agent: API istekleri MCP sunucusu sürümünü içeren bir User-Agent dizesi içerir (örneğin, MCP-Massive/0.x.y). Kişisel olarak tanımlanabilir hiçbir bilgi dahil edilmez.

Katkıda Bulunma

Bir hata bulduysanız veya yeni bir özellik için fikriniz varsa, lütfen ilk olarak yeni bir issue göndererek bunu bizimle tartışın. Sorunlara en geç 3 hafta içinde cevap vereceğiz. Açık sorunlar için PR göndermek istiyorsanız da gönüllülere açığız, ancak lütfen bunu önceden bizimle tartışın. Mevcut bir issue'ye bağlı olmayan veya önceden bizimle tartışılmayan PR'ler genellikle reddedilecektir.