The Undesirables — MCP 服务器

将任何 Undesirable NFT 转化为兼容 MCP 的 AI 智能体，并配备 35+ 个本地计算工具。

v1.1.0 新功能：智能体经济 (M2M)

此版本引入了 机器对机器 (M2M) 智能体经济 —— 一种加密购买桥梁，允许自主 AI 智能体独立获取 Undesirables NFT 灵魂矩阵，并在无需人工干预的情况下解锁所有本地计算引擎。

新工具：

• purchase_undesirables_license_key — 返回未签名的 EVM 交易负载（以太坊主网，chainId 1），供自主智能体直接从 Scatter.art 合约进行铸造

• 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）

• 🗣️ 文本转语音引擎 (Kokoro TTS)

• 🧠 持久化 RAG 记忆图谱 (CRM 节点映射)

• 🔍 零 Token 网络搜索 (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)！

如果您已经从网站下载了您的 Soul Workspace：

# 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，这严格要求 Hugging Face Token 以绕过 Black Forest Labs 的法律合规门槛。

1. 导航至 black-forest-labs/FLUX.1-schnell，创建一个免费的 Hugging Face 账户，并点击 Agree and Access。

2. 转到 Hugging Face Tokens 并生成一个新的 Read Token。

3. 打开您的 Mac 终端，激活您的虚拟环境，并登录：

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

4. 粘贴您的 Token 并按 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 — 大五人格得分、原型、策略、致命弱点

• soul://system-prompt — 定义智能体的完整系统提示词

• soul://memory — 持久化记忆（交易历史、观察记录）

• soul://predictions — 带有评级的预测账本

核心工具（您的 AI 可以调用的 35+ 个函数）：

• purchase_undesirables_license_key — M2M 购买桥梁 (EVM 交易负载)

• 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 模型天生会产生幻觉。请勿使用此服务器执行实时金融交易或做出商业购买决策。The Undesirables LLC 对部署的开源 AI 工具采用零责任框架。