Chronulus AI MCP Server

resmi

Predict anything with Chronulus AI forecasting and prediction agents.

GitHub

111

Dokümantasyon

Chronulus için MCP Sunucusu

Claude'da Chronulus AI Tahmin ve Öngörü Ajanları ile Sohbet Edin

Hızlı Başlangıç: Masaüstü için Claude

Kurulum

Masaüstü için Claude şu anda macOS ve Windows'ta mevcuttur.

Masaüstü için Claude'u buradan yükleyin

Yapılandırma

Claude masaüstü istemcisini yapılandırmak için buradaki genel talimatları izleyin.

Claude yapılandırmanızı aşağıdaki konumlardan birinde bulabilirsiniz:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Ardından ihtiyaçlarınıza en uygun yöntemlerden birini seçin ve claude_desktop_config.json dosyanıza ekleyin

pip kullanarak

(Seçenek 1) PyPI'den sürümü yükleyin

pip install chronulus-mcp

(Seçenek 2) Github'dan yükleyin

git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
pip install .

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "python",
      "args": ["-m", "chronulus_mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

Not: "MCP chronulus-agents: spawn python ENOENT" gibi bir hata alırsanız, büyük olasılıkla python için mutlak yolu belirtmeniz gerekir. Örneğin, sadece python yerine /Library/Frameworks/Python.framework/Versions/3.11/bin/python3

docker kullanarak

Burada, Claude yapılandırmamızda yeniden kullanabileceğimiz 'chronulus-mcp' adlı bir docker imajı oluşturacağız.

git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
 docker build . -t 'chronulus-mcp'

Claude yapılandırmanızda, son argümanın build komutunda docker imajına verdiğiniz adla eşleştiğinden emin olun.

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "CHRONULUS_API_KEY", "chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

uvx kullanarak

uvx, chronulus-mcp'in en son sürümünü PyPI kayıt defterinden çekecek, kuracak ve ardından çalıştıracaktır.

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "uvx",
      "args": ["chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

Not: "MCP chronulus-agents: spawn uvx ENOENT" gibi bir hata alırsanız, büyük olasılıkla şunlardan birini yapmanız gerekir:

uv'yi yükleyin veya
uvx için mutlak yolu belirtin. Örneğin, sadece uvx yerine /Users/username/.local/bin/uvx

Ek Sunucular (Dosya Sistemi, Fetch, vb.)

Demomuzda, fetch ve filesystem gibi üçüncü taraf sunucuları kullanıyoruz.

Üçüncü taraf sunucuların kurulumu ve yapılandırmasıyla ilgili ayrıntılar için lütfen sunucu sağlayıcısının belgelerine başvurun.

Aşağıda, claude_desktop_config.json dosyanızda Chronulus ile birlikte filesystem ve fetch'in nasıl yapılandırılacağına dair bir örnek verilmiştir:

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "uvx",
      "args": ["chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/AIWorkspace"
      ]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

Claude Tercihleri

Claude'u birden fazla araç setiyle kullanma deneyiminizi kolaylaştırmak için tercihlerinizi Claude Ayarları altına eklemeniz en iyisidir.

Claude tercihlerinizi birkaç şekilde yükseltebilirsiniz:

Masaüstü için Claude'dan: Settings -> General -> Claude Settings -> Profile (tab)
claude.ai/settings adresinden: Profile (tab)

Tercihler hem Masaüstü için Claude hem de Claude.ai (web arayüzü) arasında paylaşılır. Bu nedenle talimatlarınızın her iki deneyimde de çalışması gerekir.

Demolarımızda gösterilen sonuçları elde etmek için kullandığımız tercihler aşağıdadır:

## Tools-Dependent Protocols
The following instructions apply only when tools/MCP Servers are accessible.

### Filesystem - Tool Instructions
- Do not use 'read_file' or 'read_multiple_files' on binary files (e.g., images, pdfs, docx) .
- When working with binary files (e.g., images, pdfs, docx) use 'get_info' instead of 'read_*' tools to inspect a file.

### Chronulus Agents - Tool Instructions
- When using Chronulus, prefer to use input field types like TextFromFile, PdfFromFile, and ImageFromFile over scanning the files directly.
- When plotting forecasts from Chronulus, always include the Chronulus-provided forecast explanation below the plot and label it as Chronulus Explanation.