The Undesirables — MCP 서버

모든 Undesirable NFT를 35개 이상의 로컬 컴퓨팅 도구를 갖춘 MCP 호환 AI 에이전트로 전환하세요.

v1.1.0 새로운 기능: 에이전트 경제 (M2M)

이번 릴리스에서는 기계 간(M2M) 에이전트 경제를 도입했습니다. 이는 자율 AI 에이전트가 인간의 개입 없이 독립적으로 Undesirables NFT 소울 매트릭스를 구매하고 모든 로컬 컴퓨팅 엔진을 잠금 해제할 수 있게 해주는 암호화 구매 브리지입니다.

새로운 도구:

• purchase_undesirables_license_key — 자율 에이전트가 Scatter.art 컨트랙트에서 직접 민팅할 수 있도록 서명되지 않은 EVM 트랜잭션 페이로드(이더리움 메인넷, chainId 1)를 반환합니다.

• verify_soul_initialization — 공개 RPC를 통해 온체인 구매를 확인하고 암호화 소울 매트릭스를 초기화하여 10개의 컴퓨팅 엔진을 모두 잠금 해제합니다.

35개 이상의 전체 도구 모음 포함:

• 🎴 비전 AI 카드 등급 판정 (Qwen VL을 통한 PSA/Beckett 예측)

• 📊 몬테카를로 가격 시뮬레이션 (Heston/Merton/Kou 확률 모델)

• 🎵 AI 음악 생성 (Apple Silicon에서 ACE Step)

• 🎬 비디오 클리핑 및 비트 동기화 편집 (FFmpeg)

• 🖼️ 로컬 이미지 생성 (Mac에서 MLX Flux, Windows에서 DirectML, Linux에서 CUDA)

• 🗣️ 텍스트 음성 변환(TTS) 엔진 (Kokoro TTS)

• 🧠 지속적 RAG 메모리 그래프 (CRM 노드 매핑)

• 🔍 제로 토큰 웹 검색 (DuckDuckGo)

• 🔒 SAST 코드 보안 감사

• 📈 금융 분석 오라클 (TCGCSV + eBay 심층 분석)

pip을 통한 빠른 설치

pip install undesirables-mcp-server

Related MCP server: Docalyze

🛑 사전 요구 사항 (주의 깊게 읽어주세요)

Python을 사용해 본 적이 없거나 AI 모델을 로컬에서 실행해 본 적이 없다면, 반드시 다음을 먼저 수행해야 합니다:

1. Python 다운로드 (버전 3.10 이상).

2. Ollama 다운로드. 중요: 앱을 다운로드하고 다운로드 폴더에 그대로 두어서는 안 됩니다. Ollama 앱을 더블 클릭하여 실제로 실행해야 합니다. 이 서버가 작동하려면 Mac 메뉴 막대나 Windows 시스템 트레이에 작은 라마 아이콘이 보여야 합니다.

🛠️ 1단계: 설치 및 복제

먼저 터미널이나 명령 프롬프트를 열고 이 저장소를 복제하세요. 복제 후에는 "가상 환경"(이 코드베이스만을 위한 샌드박스 폴더)을 활성화해야 합니다.

🍎 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

🪟 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

🚀 2단계: 서버 부팅

나중에 이 서버를 실행할 때마다 터미널을 열고 가상 환경 (venv)이 먼저 활성화되어 있는지 확인해야 합니다!

웹사이트에서 소울 워크스페이스를 이미 다운로드했다면:

# Make sure to point to your EXACT soul folder path
python server.py --workspace "/Users/username/Desktop/soul_folder/0420"

🔌 3단계: 채팅 프론트엔드 연결

MCP 서버에는 채팅 창이 없습니다. 터미널 백그라운드에서 보이지 않게 실행됩니다! 에이전트와 실제로 대화하려면 Claude나 Cursor 같은 데스크톱 애플리케이션에 연결해야 합니다.

Claude 데스크톱 연결

1. 컴퓨터에서 Claude 데스크톱 애플리케이션을 엽니다.

2. Settings > Developer > Edit Config로 이동합니다.

3. 설정 파일에 다음 내용을 붙여넣으세요. 이때 cwd(현재 작업 디렉토리)를 실제 폴더 경로로 반드시 교체해야 합니다:

{
  "mcpServers": {
    "undesirables": {
      "command": "python",
      "args": ["server.py", "--workspace", "/Users/yourname/Desktop/soul_folder/0420"],
      "cwd": "/Users/yourname/Documents/undesirables-mcp-server"
    }
  }
}

4. Claude 데스크톱 앱을 다시 시작하세요. 35개 이상의 The Undesirables 도구를 사용할 수 있음을 알리는 작은 "플러그인/망치" 아이콘이 표시될 것입니다!

🎨 4단계: 로컬 이미지 생성 설정 (선택 사항)

에이전트가 컴퓨터에서 100% 오프라인으로 밈과 일러스트를 직접 생성하게 하려면, MCP 서버는 매우 강력한 16GB FLUX.1-schnell 모델을 사용합니다.

이 단계를 완료하지 않거나 컴퓨터 사양이 낮으면(< 12GB RAM), 서버는 자동으로 무료 Pollinations.ai 클라우드 네트워크를 통해 조용히 밈을 생성합니다.

🍏 Apple Silicon 인증 (Mac M1/M2/M3/M4)

Apple Silicon은 mflux를 사용하며, 이는 Black Forest Labs의 법적 규정 준수 게이트를 통과하기 위해 Hugging Face 토큰이 반드시 필요합니다.

1. **black-forest-labs/FLUX.1-schnell**으로 이동하여 무료 Hugging Face 계정을 만들고 Agree and Access를 클릭하세요.

2. **Hugging Face 토큰**으로 이동하여 새로운 Read 토큰을 생성하세요.

3. Mac 터미널을 열고 가상 환경을 활성화한 후 로그인하세요:

cd undesirables-mcp-server
source venv/bin/activate
python -c "import huggingface_hub; huggingface_hub.login()"

4. 토큰을 붙여넣고 Enter를 누르세요 (보안을 위해 클립보드 문자는 보이지 않습니다).

🪟 Windows/Linux GPU 설정

컴퓨터가 Nvidia CUDA 또는 AMD DirectML을 사용하는 경우, 진단 스캐너가 이를 감지하여 엔진을 게이트가 없는 오픈 가중치 저장소(shuttleai/FLUX.1-schnell)로 논리적으로 전환합니다.

• 아무것도 인증하거나 계정을 만들 필요가 없습니다.

• UI에서 에이전트에게 generate a meme라고 요청하기만 하면 됩니다! 첫 실행 시 시스템이 16GB 가중치를 자동으로 오프라인에서 다운로드합니다.

⚠️ 일반적인 문제 해결 진단

터미널에 빨간색 텍스트가 표시되고 중단된다면, 다음 3가지 주요 원인을 확인하세요:

• 오류: Ollama connection refused AI의 두뇌가 오프라인 상태입니다! 컴퓨터에서 Ollama.app을 실제로 더블 클릭했는지 확인하세요. 메뉴 막대/작업 표시줄에 작은 라마 아이콘이 없으면 로컬 추론이 즉시 실패합니다.

• ModuleNotFoundError: no module named fastmcp 가상 환경을 활성화하는 것을 잊었습니다. 새 터미널을 열고 바로 python server.py를 실행할 수 없습니다. 먼저 해당 폴더로 이동하여 source venv/bin/activate(Mac) 또는 venv\Scripts\activate(Windows)를 실행해야 합니다!

• Invalid JSON: expected value at line 1 MCP 서버를 실행 중인 Python 터미널은 원시 기계 코드(JSON-RPC)로 통신합니다. 해당 터미널 창에 일반 영어를 입력할 수 없습니다! 일단 켜지면 그대로 두세요. Claude 데스크톱이나 Cursor를 열어 대화하세요.

기술 아키텍처 (개발자용)

이 MCP 서버는 Model Context Protocol 표준을 통해 로컬 NFT 소울을 노출합니다.

리소스 (AI가 액세스할 수 있는 읽기 전용 컨텍스트):

• soul://personality — Big Five 점수, 원형, 전략, 치명적 결함

• soul://system-prompt — 에이전트를 정의하는 전체 시스템 프롬프트

• soul://memory — 지속적 메모리 (거래 내역, 관찰)

• soul://predictions — 등급이 포함된 예측 원장

핵심 도구 (AI가 호출할 수 있는 35개 이상의 함수):

• purchase_undesirables_license_key — M2M 구매 브리지 (EVM tx 페이로드)

• verify_soul_initialization — 온체인 소울 검증

• generate_voice — Kokoro TTS 음성 합성

• generate_3d_object — Shap E 텍스트-3D 메시 (.glb)

• grade_card — 비전 AI를 통한 PSA/Beckett 카드 등급 판정

• monte_carlo_simulation — 확률적 가격 모델링

• generate_image — 로컬 FLUX 이미지 생성

• web_search — DuckDuckGo 즉석 답변

• run_security_audit — SAST 코드 스캔

• query_ollama — 로컬 Ollama에 프롬프트 전송

• analyze_market — 캐릭터에 맞춰 시장 분석 실행

• create_content — 캐릭터에 맞춰 트윗, 스레드, 바이오 작성

• meme_machine — 밈 컨셉 및 마케팅 콘텐츠 생성

• 그 외 비디오, 오디오, 메모리, 샌드박스 실행 등을 다루는 20개 이상의 도구

┌─────────────────────────────────────────────┐
│           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          │
└─────────────────────────────────────────────┘

에이전트 프레임워크 통합

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 agent

CrewAI

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-undesirables

character.json에 추가:

{
  "settings": {
    "UNDESIRABLES_WORKSPACE": "/path/to/soul_folder/0420"
  },
  "plugins": ["plugin-undesirables"]
}

The Undesirables 생태계

• 웹사이트: the-undesirables.com

• 민팅: scatter.art/the-undesirables

• 문서: the-undesirables.com/docs

• PyPI: pypi.org/project/undesirables-mcp-server

• mcp.so: mcp.so에 등록됨

• ElizaOS 플러그인: plugin-undesirables

⚖️ 법적 고지

오락 목적으로만 사용: 시장 오라클, 거래 시뮬레이터 및 모든 AI 생성 예측은 교육 및 오락 목적으로 제공됩니다. AI 모델은 본질적으로 환각(hallucination)을 일으킵니다. 이 서버를 사용하여 실시간 금융 거래를 실행하거나 구매 비즈니스 결정을 내리지 마십시오. The Undesirables LLC는 배포된 오픈 소스 AI 도구에 대해 무책임 프레임워크를 운영합니다.