The Undesirables — MCP Server
👁 Python Runtime
👁 FastMCP
👁 License: Apache 2.0
👁 PyPI
Undesirable NFTを、35以上のローカル計算ツールを備えたMCP互換AIエージェントに変身させましょう。
v1.1.0の新機能: エージェント経済 (M2M)
今回のリリースでは、マシン・ツー・マシン (M2M) エージェント経済を導入しました。これは、自律型AIエージェントが人間を介さずに独自にUndesirables NFTソウルマトリックスを購入し、すべてのローカル計算エンジンをアンロックできる暗号資産購入ブリッジです。
新しいツール:
purchase_undesirables_license_key— 自律型エージェントがScatter.artコントラクトから直接ミントするための、署名されていないEVMトランザクションペイロード(Ethereumメインネット、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)
🗣️ テキスト読み上げ音声エンジン (Kokoro TTS)
🧠 永続的なRAGメモリグラフ (CRMノードマッピング)
🔍 ゼロトークンWeb検索 (DuckDuckGo)
🔒 SASTコードセキュリティ監査
📈 金融分析オラクル (TCGCSV + eBay詳細分析)
pipによるクイックインストール
pip install undesirables-mcp-serverRelated MCP server: Yantrix MCP
🛑 前提条件 (必ずお読みください)
Pythonを使用したことがない、またはAIモデルをローカルで実行したことがない場合は、必ず最初にこれを行ってください:
Pythonをダウンロード (バージョン3.10以上)。
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 Desktopへの接続
コンピュータでClaude Desktopアプリケーションを開きます。
Settings > Developer > Edit Config に移動します。
設定ファイルに以下を貼り付けます。その際、
cwd(現在の作業ディレクトリ) を正確なフォルダパスに置き換えていることを必ず確認してください:
{
"mcpServers": {
"undesirables": {
"command": "python",
"args": ["server.py", "--workspace", "/Users/yourname/Desktop/soul_folder/0420"],
"cwd": "/Users/yourname/Documents/undesirables-mcp-server"
}
}
}Claude Desktopアプリを再起動します。35以上のThe Undesirablesツールが利用可能になったことを示す「プラグイン/ハンマー」アイコンが表示されるはずです!
🎨 ステップ 4: ローカル画像生成のセットアップ (オプション)
エージェントにコンピュータ上で100%オフラインでミームやイラストを物理的に生成させたい場合、MCPサーバーは非常に強力な16GBの FLUX.1-schnell モデルを使用します。
このステップを完了しない場合、またはコンピュータの性能が不足している場合(RAM 12GB未満)、サーバーは自動的にフォールバックし、無料の Pollinations.ai クラウドネットワーク経由で静かにミームを生成します。
🍏 Apple Silicon (Mac M1/M2/M3/M4) の認証
Apple Siliconは特に mflux を使用します。これには、Black Forest Labsの法的コンプライアンスゲートを回避するために、Hugging Faceトークンが必須となります。
black-forest-labs/FLUX.1-schnell に移動し、無料のHugging Faceアカウントを作成して、「Agree and Access」をクリックします。
Hugging Face Tokens に移動し、新しい Read トークンを生成します。
Macのターミナルを開き、仮想環境をアクティブにしてログインします:
cd undesirables-mcp-server
source venv/bin/activate
python -c "import huggingface_hub; huggingface_hub.login()"トークンを貼り付けて
Enterを押します (セキュリティのため、クリップボードの文字は表示されません)。
🪟 Windows/Linux GPUのセットアップ
コンピュータがNvidia CUDAまたはAMD DirectMLを使用している場合、診断スキャナーがこれを検出し、論理的にエンジンを ゲートなしのオープンウェイトリポジトリ (shuttleai/FLUX.1-schnell) に切り替えます。
認証やアカウント作成は一切不要です。
UIでエージェントに
generate a memeと頼むだけです!初回実行時に、システムが自動的に16GBのウェイトを完全にオフラインでダウンロードします。
⚠️ よくあるトラブルシューティング
ターミナルに赤い文字が表示されて停止する場合は、以下の3つの主な原因を確認してください:
Error: 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 DesktopまたはCursorを開いてチャットしてください。
技術アーキテクチャ (開発者向け)
このMCPサーバーは、Model Context Protocol 標準を通じてローカルのNFTソウルを公開します。
リソース (AIがアクセスできる読み取り専用コンテキスト):
soul://personality— ビッグファイブスコア、アーキタイプ、戦略、致命的な欠陥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 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-undesirablescharacter.json に追加:
{
"settings": {
"UNDESIRABLES_WORKSPACE": "/path/to/soul_folder/0420"
},
"plugins": ["plugin-undesirables"]
}The Undesirables エコシステム
ウェブサイト: the-undesirables.com
ドキュメント: the-undesirables.com/docs
mcp.so: mcp.soに掲載
ElizaOSプラグイン: plugin-undesirables
⚖️ 免責事項
娯楽目的のみ: 市場オラクル、取引シミュレーター、およびすべてのAI生成予測は、教育および娯楽目的のものです。AIモデルは本質的にハルシネーション(幻覚)を起こします。このサーバーを使用してライブの金融取引を実行したり、ビジネス上の購入決定を行ったりしないでください。The Undesirables LLCは、デプロイされたオープンソースAIツールに対して免責フレームワークを運用しています。
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
