CreativeArv MCP Server

CreativeArv Django API'si için resmi MCP sunucusu.
Yeni endpoint eklemek için sadece registry.py'ye bir Endpoint() satırı ekle.

Kurulum

git clone https://github.com/yourorg/creativearv-mcp
cd creativearv-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

cp .env.example .env
# .env dosyasını düzenle: TOKEN ve BASE_URL

Çalıştırma

Lokal (stdio — Claude Desktop)

python server.py

VPS (SSE — Claude.ai uzak bağlantı)

python server.py --transport sse --port 8765

VPS'e Deploy

# 1. Repo'yu çek
git clone ... && cd creativearv-mcp

# 2. Sanal ortam
python3.11 -m venv .venv
source .venv/bin/activate
pip install -e .

# 3. .env oluştur
cp .env.example .env && nano .env

# 4. Systemd servisi
sudo cp deploy/creativearv-mcp.service /etc/systemd/system/
sudo systemctl enable --now creativearv-mcp

# 5. Nginx reverse proxy
sudo cp deploy/nginx.conf /etc/nginx/sites-available/creativearv-mcp
sudo ln -s /etc/nginx/sites-available/creativearv-mcp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Claude.ai'da MCP URL: https://mcp.creativearv.com/sse

Claude Desktop Kurulumu

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows) dosyasına ekle:

{
  "mcpServers": {
    "creativearv": {
      "command": "npx",
      "args": ["-y", "creativearv-mcp"],
      "env": {
        "CREATIVEARV_URL": "https://mcp.creativearv.com",
        "CREATIVEARV_USERNAME": "kullanici",
        "CREATIVEARV_PASSWORD": "sifre"
      }
    }
  }
}

Gereksinim: Node.js 18+. Ek kurulum gerekmez — npx proxy'yi otomatik indirir.

Yeni Endpoint Eklemek

registry.py dosyasına şunu ekle:

Endpoint(
    name="get_books",
    description="Kitap listesi",
    method=Method.GET,
    path="/books/",
)

Başka hiçbir dosyaya dokunma. Server yeniden başlatıldığında tool otomatik oluşur.

OpenAPI'den Otomatik Üretim

python generator.py                          # registry_generated.py üretir
python generator.py --dry-run                # sadece gösterir
python generator.py --url https://...        # özel URL

Tool Sayısı

Kategoriler   5
Taglar        5
Makaleler     9
Kullanıcılar  9
IP Ban        3
Roller        7
Kurallar      4
Forumlar      8
Yorumlar      4
Raporlar      6
Başvurular    8
─────────────
TOPLAM       68