The Undesirables — MCP-Server
👁 Python Runtime
👁 FastMCP
👁 License: Apache 2.0
👁 PyPI
Verwandle jedes Undesirable-NFT in einen MCP-kompatiblen KI-Agenten mit über 35 lokalen Rechen-Tools.
Was ist neu in v1.1.0: Agenten-Ökonomie (M2M)
Diese Version führt die Machine-to-Machine (M2M) Agenten-Ökonomie ein — eine kryptografische Kaufbrücke, die es autonomen KI-Agenten ermöglicht, unabhängig eine Undesirables-NFT-Seelenmatrix zu erwerben und alle lokalen Rechen-Engines ohne menschliches Eingreifen freizuschalten.
Neue Tools:
purchase_undesirables_license_key— Gibt ein unsigniertes EVM-Transaktions-Payload (Ethereum Mainnet, chainId 1) zurück, damit autonome Agenten direkt vom Scatter.art-Vertrag minten könnenverify_soul_initialization— Überprüft den On-Chain-Kauf über einen öffentlichen RPC und initialisiert die kryptografische Seelenmatrix, wodurch alle 10 Rechen-Engines freigeschaltet werden
Die vollständige Suite mit über 35 Tools umfasst:
🎴 Vision-KI-Kartenbewertung (PSA/Beckett-Vorhersage via Qwen VL)
📊 Monte-Carlo-Preissimulation (stochastische Heston/Merton/Kou-Modelle)
🎵 KI-Musikgenerierung (ACE Step auf Apple Silicon)
🎬 Video-Clipping und Beat-Sync-Bearbeitung (FFmpeg)
🖼️ Lokale Bildgenerierung (MLX Flux auf Mac, DirectML auf Windows, CUDA auf Linux)
🗣️ Text-to-Speech-Voice-Engine (Kokoro TTS)
🧠 Persistente RAG-Speichergraphen (CRM-Knotenzuordnung)
🔍 Zero-Token-Websuche (DuckDuckGo)
🔒 SAST-Code-Sicherheitsprüfung
📈 Finanzanalyse-Orakel (TCGCSV + eBay-Tiefenanalyse)
Schnelle Installation via pip
pip install undesirables-mcp-serverRelated MCP server: Yantrix MCP
🛑 Voraussetzungen (Bitte sorgfältig lesen)
Wenn du noch nie Python verwendet oder KI-Modelle lokal ausgeführt hast, musst du dies zuerst tun:
Python herunterladen (Version 3.10 oder höher).
Ollama herunterladen. KRITISCH: Du kannst die App nicht einfach herunterladen und in deinem Download-Ordner lassen. Du musst die Ollama-App per Doppelklick physisch ausführen. Du solltest ein kleines Lama-Symbol in deiner Mac-Menüleiste oder Windows-Taskleiste sehen, damit dieser Server funktioniert.
🛠️ Schritt 1: Installieren & Klonen
Öffne zuerst dein Terminal oder die Eingabeaufforderung und klone dieses Repository. Nach dem Klonen musst du eine „virtuelle Umgebung“ (einen Sandbox-Ordner nur für diesen Code) aktivieren.
🍎 Auf Mac / Linux
git clone https://gitlab.com/meme-merchants/undesirables-mcp-server.git
cd undesirables-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt🪟 Auf Windows
git clone https://gitlab.com/meme-merchants/undesirables-mcp-server.git
cd undesirables-mcp-server
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt🚀 Schritt 2: Den Server starten
Jedes Mal, wenn du diesen Server später ausführen möchtest, musst du dein Terminal öffnen und sicherstellen, dass deine virtuelle Umgebung (venv) zuerst aktiviert ist!
Wenn du deinen Soul-Workspace bereits von der Website heruntergeladen hast:
# Make sure to point to your EXACT soul folder path
python server.py --workspace "/Users/username/Desktop/soul_folder/0420"🔌 Schritt 3: Dein Chat-Frontend verbinden
Der MCP-Server hat kein Chat-Fenster; er läuft unsichtbar im Hintergrund deines Terminals! Um tatsächlich mit deinem Agenten zu sprechen, musst du ihn mit einer Desktop-Anwendung wie Claude oder Cursor verbinden.
Claude Desktop-Verbindung
Öffne die Claude Desktop-Anwendung auf deinem Computer.
Gehe zu Settings > Developer > Edit Config.
Füge dies in deine Konfigurationsdatei ein und stelle unbedingt sicher, dass du
cwd(Current Working Directory) durch deinen exakten Ordnerpfad ersetzt:
{
"mcpServers": {
"undesirables": {
"command": "python",
"args": ["server.py", "--workspace", "/Users/yourname/Desktop/soul_folder/0420"],
"cwd": "/Users/yourname/Documents/undesirables-mcp-server"
}
}
}Starte die Claude Desktop-App neu. Du solltest ein kleines „Plugin/Hammer“-Symbol sehen, das dir anzeigt, dass über 35 The Undesirables-Tools jetzt verfügbar sind!
🎨 Schritt 4: Lokale Bildgenerierung einrichten (Optional)
Wenn du möchtest, dass dein Agent physisch Memes und Illustrationen zu 100 % offline nativ auf deinem Computer generiert, verwendet der MCP-Server das massiv leistungsstarke 16-GB-Modell FLUX.1-schnell.
Wenn du diesen Schritt nicht abschließt oder dein Computer zu schwach ist (< 12 GB RAM), greift der Server automatisch zurück und generiert Memes für dich lautlos über das kostenlose Pollinations.ai-Cloud-Netzwerk.
🍏 Authentifizierung für Apple Silicon (Mac M1/M2/M3/M4)
Apple Silicon verwendet spezifisch mflux, was zwingend ein Hugging-Face-Token erfordert, um die rechtliche Compliance-Sperre von Black Forest Labs zu umgehen.
Navigiere zu black-forest-labs/FLUX.1-schnell, erstelle ein kostenloses Hugging-Face-Konto und klicke auf Agree and Access.
Gehe zu Hugging Face Tokens und generiere ein neues Read-Token.
Öffne dein Mac-Terminal, aktiviere deine virtuelle Umgebung und logge dich ein:
cd undesirables-mcp-server
source venv/bin/activate
python -c "import huggingface_hub; huggingface_hub.login()"Füge dein Token ein und drücke Enter (deine Zwischenablage-Zeichen sind aus Sicherheitsgründen unsichtbar).
🪟 Einrichtung für Windows/Linux-GPUs
Wenn dein Computer Nvidia CUDA oder AMD DirectML verwendet, erkennt der Diagnose-Scanner dies und verschiebt deine Engine logischerweise auf ein ungesperrtes Open-Weights-Repository (shuttleai/FLUX.1-schnell).
Du musst nichts authentifizieren oder ein Konto erstellen.
Bitte deinen Agenten einfach, ein
generate a memein der Benutzeroberfläche auszuführen! Dein System lädt die 16-GB-Gewichte bei der allerersten Ausführung automatisch vollständig offline herunter.
⚠️ Häufige idiotensichere Diagnosen
Wenn dein Terminal roten Text ausgibt und anhält, überprüfe diese Top-3-Gründe:
Error: Ollama connection refused Das Gehirn deiner KI ist offline! Stelle sicher, dass du die Ollama.app auf deinem Computer physisch per Doppelklick gestartet hast. Wenn das kleine Lama-Symbol nicht in deiner Menüleiste/Taskleiste ist, schlägt die lokale Inferenz sofort fehl.
ModuleNotFoundError: no module named fastmcp Du hast vergessen, deine virtuelle Umgebung zu aktivieren. Du kannst nicht einfach ein neues Terminal starten und
python server.pyausführen. Du musst zuerst zum Ordner navigieren undsource venv/bin/activate(Mac) odervenv\Scripts\activate(Windows) ausführen!Invalid JSON: expected value at line 1 Das Python-Terminal, das den MCP-Server ausführt, kommuniziert in rohem Maschinencode (JSON-RPC). Du kannst kein einfaches Englisch in dieses Terminalfenster tippen! Sobald es eingeschaltet ist, lass es in Ruhe. Öffne Claude Desktop oder Cursor, um mit ihm zu chatten.
Technische Architektur (Für Entwickler)
Dieser MCP-Server macht deine lokale NFT-Seele über den Standard Model Context Protocol zugänglich.
Ressourcen (schreibgeschützter Kontext, auf den deine KI zugreifen kann):
soul://personality— Big-Five-Werte, Archetyp, Strategie, fataler Fehlersoul://system-prompt— Der vollständige System-Prompt, der den Agenten definiertsoul://memory— Persistenter Speicher (Handelshistorie, Beobachtungen)soul://predictions— Vorhersage-Ledger mit Bewertungen
Kern-Tools (über 35 Funktionen, die deine KI aufrufen kann):
purchase_undesirables_license_key— M2M-Kaufbrücke (EVM-Tx-Payload)verify_soul_initialization— On-Chain-Seelenverifizierunggenerate_voice— Kokoro TTS-Sprachsynthesegenerate_3d_object— Shap-E Text-zu-3D-Mesh (.glb)grade_card— PSA/Beckett-Kartenbewertung via Vision-KImonte_carlo_simulation— Stochastische Preismodellierunggenerate_image— Lokale FLUX-Bildgenerierungweb_search— DuckDuckGo-Sofortantwortenrun_security_audit— SAST-Code-Scanquery_ollama— Prompts an lokales Ollama sendenanalyze_market— Marktanalyse im Charakter ausführencreate_content— Tweets, Threads, Bios im Charakter schreibenmeme_machine— Meme-Konzepte und Marketing-Inhalte generierenUnd über 20 weitere, die Video, Audio, Speicher und Sandbox-Ausführung abdecken
┌─────────────────────────────────────────────┐
│ MCP Client (Cursor, Claude) │
└──────────────────┬──────────────────────────┘
│ JSON-RPC (stdio)
┌──────────────────▼──────────────────────────┐
│ Undesirables MCP Server │
│ ┌──────────┐ ┌──────────┐ ┌────────────┐ │
│ │Resources │ │ Tools │ │ Prompts │ │
│ │SOUL.md │ │Skills │ │Templates │ │
│ │MEMORY.md │ │Ollama │ │ │ │
│ │Predictions│ │Analysis │ │ │ │
│ └──────────┘ └────┬─────┘ └────────────┘ │
└────────────────────┼────────────────────────┘
│ HTTP
┌────────────────────▼────────────────────────┐
│ Ollama (Local LLM) │
│ llama3.1:8b / qwen / etc │
└─────────────────────────────────────────────┘Integration des Agenten-Frameworks
LangChain / LangGraph
from langchain_mcp_adapters.client import MultiServerMCPClient
async with MultiServerMCPClient({
"undesirables": {
"command": "python",
"args": ["server.py", "--workspace", "/path/to/soul_folder/0420"],
"cwd": "/path/to/undesirables-mcp-server"
}
}) as client:
tools = client.get_tools()
# 35+ tools now available to any LangChain agentCrewAI
from crewai import Agent
from crewai_tools import MCPServerAdapter
mcp = MCPServerAdapter(
command="python",
args=["server.py", "--workspace", "/path/to/soul_folder/0420"]
)
agent = Agent(
role="NFT Card Grader",
tools=mcp.tools,
goal="Grade trading cards and run Monte Carlo price simulations"
)OpenAI Agents SDK
from agents import Agent
from agents.mcp import MCPServerStdio
mcp_server = MCPServerStdio(
command="python",
args=["server.py", "--workspace", "/path/to/soul_folder/0420"]
)
agent = Agent(
name="Undesirables Agent",
instructions="You are an autonomous AI agent with NFT soul personality.",
mcp_servers=[mcp_server]
)ElizaOS
npm install plugin-undesirablesFüge dies zu deiner character.json hinzu:
{
"settings": {
"UNDESIRABLES_WORKSPACE": "/path/to/soul_folder/0420"
},
"plugins": ["plugin-undesirables"]
}Das Undesirables-Ökosystem
Website: the-undesirables.com
Dokumentation: the-undesirables.com/docs
mcp.so: Gelistet auf mcp.so
ElizaOS-Plugin: plugin-undesirables
⚖️ Rechtlicher Hinweis
Nur zu Unterhaltungszwecken: Das Markt-Orakel, Handelssimulatoren und alle KI-generierten Vorhersagen dienen Bildungs- und Unterhaltungszwecken. KI-Modelle halluzinieren nativ. Verwende diesen Server nicht, um Live-Finanzgeschäfte auszuführen oder geschäftliche Kaufentscheidungen zu treffen. The Undesirables LLC betreibt ein Framework ohne Haftung für bereitgestellte Open-Source-KI-Tools.
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sailorpepe/undesirables-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
