# Whykiki Anything World MCP Server

[![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![MCP](https://img.shields.io/badge/MCP-1.0+-green.svg)](https://modelcontextprotocol.io/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Ein **Model Context Protocol (MCP)** Server für die [Anything World API](https://anything.world/). Dieser Server ermöglicht es Claude und anderen MCP-Clients, 3D-Modelle zu generieren, animieren und zu durchsuchen.

## ✨ Features

- 🔍 **Modell-Suche**: Durchsuche die Anything World Bibliothek nach 3D-Modellen
- 🎨 **Text-zu-3D**: Generiere 3D-Modelle aus Textbeschreibungen
- 🖼️ **Bild-zu-3D**: Erstelle 3D-Modelle aus Bildern
- 🎬 **Animation**: Animiere hochgeladene 3D-Modelle automatisch
- ⚡ **Generiere & Animiere**: Erstelle und animiere Modelle in einem Schritt
- 📊 **Status-Tracking**: Verfolge den Fortschritt von Generierungs- und Animationsprozessen

## 🚀 Installation

### Voraussetzungen

- Python 3.10 oder höher
- Ein [Anything World API Key](https://app.anything.world/register)
- Claude Desktop oder ein anderer MCP-Client

### Schritt 1: Installiere das Paket

```bash
pip install whykiki-anything-world-mcp
```

Oder für die Entwicklung:

```bash
git clone https://github.com/TheWhykiki/whykiki-anything-world-mcp.git
cd whykiki-anything-world-mcp
pip install -e .
```

### Schritt 2: Konfiguriere deinen API Key

Erstelle eine `.env` Datei in deinem Projektverzeichnis:

```env
AW_API_KEY=your_anything_world_api_key_here
```

### Schritt 3: Konfiguriere Claude Desktop

Füge folgendes zu deiner Claude Desktop Konfiguration hinzu:

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

```json
{
  "mcpServers": {
    "whykiki-anything-world": {
      "command": "python",
      "args": [
        "-m",
        "whykiki_anything_world_mcp"
      ],
      "env": {
        "AW_API_KEY": "your_anything_world_api_key_here"
      }
    }
  }
}
```

## 🎯 Verwendung

Nach der Installation und Konfiguration kannst du den MCP Server über Claude Desktop verwenden.

## 📝 Lizenz

MIT License

## 🙏 Danksagungen

- [Anything World](https://anything.world/) für ihre großartige API
- [Model Context Protocol](https://modelcontextprotocol.io/) Team
- [Anthropic](https://www.anthropic.com/) für Claude