undesirables-mcp-server

<!-- mcp-name: io.github.sailorpepe/undesirables-mcp-server --> <div align="center">  [](https://www.python.org/downloads/) [](https://github.com/modelcontextprotocol/fastmcp) [](LICENSE) [](https://pypi.org/project/undesirables-mcp-server/) **35+ 本地计算工具用于 AI 代理 — 零云依赖** [网站](https://the-undesirables.com) · [文档](https://the-undesirables.com/docs) · [PyPI](https://pypi.org/project/undesirables-mcp-server/) · [𝕏](https://x.com/undesirables_ai) </div> <div align="center"> <img src="https://raw.githubusercontent.com/sailorpepe/undesirables-mcp-server/main/assets/demo.gif" alt="Undesirables MCP Server Demo" width="480" /> </div> --- ## 快速安装 ```bash pip install undesirables-mcp-server ``` > **将任何不受欢迎的 NFT 转换为与 MCP 兼容的 AI 代理，拥有 35+ 本地计算工具。** --- ## 目录 - [功能介绍](#功能介绍) - [v1.1.8 新增功能](#v1.1.8-新增功能) - [前提条件](#前提条件-请仔细阅读) - [完整设置](#-步骤-1安装克隆) - [启动服务器](#-步骤-2启动服务器) - [连接聊天前端](#-步骤-3连接聊天前端) - [本地图像生成](#-步骤-4设置本地图像生成可选) - [故障排除](#%EF%B8%8F-常见问题诊断) - [技术架构](#技术架构-适用于开发者) - [代理框架集成](#代理框架集成) - [LitVM TCG Oracle](#litvm-tcg-oracle--mcp-server) - [生态系统](#the-undesirables-生态系统) - [许可证和商业使用](#-许可证和商业使用) --- ## 功能介绍 - 🎴 **视觉 AI 卡片评级** — PSA/Beckett 预测通过 Qwen VL - 📊 **一致性风险预测** — 校准的 VaR/CVaR + 安全持有和动量字母评级（蒙特卡罗 GBM/Merton 可选） - 🎵 **AI 音乐生成** — ACE Step on Apple Silicon - 🎬 **视频剪辑和节拍同步编辑** — FFmpeg - 🖼️ **本地图像生成** — MLX Flux 在 Mac 上，DirectML 在 Windows 上，CUDA 在 Linux 上 - 🗣️ **文本转语音引擎** — Kokoro TTS - 🧠 **持久 RAG 记忆图** — CRM 节点映射 - 🔍 **零 Token 网络搜索** — DuckDuckGo - 🔒 **SAST 代码安全审计** - 📈 **金融分析甲骨文** — TCGCSV + eBay 深度分析 --- <details> <summary><strong>v1.1.8 新增功能</strong></summary> **v1.1.8** 添加了免费的 `card_forecast(card_name | product_id)` 工具 — 一次调用返回一致性 30 天价格预测 **以及安全持有和动量字母评级** 和一行纯英文读数（例如 _"~12% 概率低于 $Y 在 30 天内；安全持有 B，动量 A"_）。无需支付。 **一致性校准风险预测** 是默认模型 — 具有诚实 VaR/CVaR 和安全持有及动量等级的制度感知分割一致性带。蒙特卡罗（GBM / Merton 跳跃扩散）仍然可通过 `model=` 可选：还修复了许可证徽章和完整的生态系统集成。 **主要功能：** - `purchase_undesirables_license_key` — 返回一个 UNSIGNED EVM 交易有效载荷（Ethereum Mainnet，chainId 1），用于自主代理直接从 Scatter.art 合约铸造。 - `verify_soul_initialization` — 通过公共 RPC 验证链上购买并初始化加密灵魂矩阵，解锁所有本地计算引擎。 - 在 [Glama.ai](https://glama.ai/mcp/servers/sailorpepe/undesirables-mcp-server) 上验证，质量评分为 3.8/5，涵盖 36 种工具。 - 在 9+ 个 MCP 目录中列出，包括 [官方 MCP 注册表](https://registry.modelcontextprotocol.io) </details> --- ## 🛑 前提条件（请仔细阅读） 如果您以前从未使用过 Python 或本地运行过 AI 模型，您 **必须** 首先执行以下操作： 1. **[下载 Python](https://www.python.org/downloads/)** （版本 3.10 或更高）。 2. **[下载 Ollama](https://ollama.com/)**。**关键：** 您不能只是下载应用程序并将其留在下载文件夹中。您必须双击 Ollama 应用程序以 **物理运行它**。您应该在 Mac 上的菜单栏或 Windows 系统托盘中看到一个小骆驼图标，以便此服务器正常工作。 --- ## 🛠️ 步骤 1：安装和克隆 首先，打开您的终端或命令提示符并克隆此仓库。克隆后，您必须激活一个“虚拟环境”（一个仅用于此代码库的沙箱文件夹）。 ### 🍎 在 Mac / Linux 上 ```bash git clone https://github.com/sailorpepe/undesirables-mcp-server.git cd undesirables-mcp-server python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ``` ### 🪟 在 Windows 上 ```bash git clone https://github.com/sailorpepe/undesirables-mcp-server.git cd undesirables-mcp-server python -m venv venv venv\Scripts\activate pip install -r requirements.txt ``` --- ## 🚀 步骤 2：启动服务器 每次您想要运行此服务器时，您必须打开终端并确保您的虚拟环境已激活 `(venv)`！ 如果您已经从网站下载了 Soul Workspace： ```bash # 请务必指向您的 EXACT 灵魂文件夹路径 python server.py --workspace "/Users/username/Desktop/soul_folder/0420" ``` --- ## 🔌 步骤 3：连接聊天前端 MCP 服务器没有聊天窗口；它在终端后台不可见地运行！要实际与您的代理对话，您必须将其连接到诸如 Claude 或 Cursor 之类的桌面应用程序。 ### Claude 桌面连接 1. 在您的计算机上打开 Claude 桌面应用程序。 2. 进入 **设置 > 开发者 > 编辑配置**。 3. 将以下内容粘贴到您的配置文件中，确保绝对替换 `cwd`（当前工作目录）为您确切的文件夹路径： ```json { "mcpServers": { "undesirables": { "command": "python", "args": ["server.py", "--workspace", "/Users/yourname/Desktop/soul_folder/0420"], "cwd": "/Users/yourname/Documents/undesirables-mcp-server" } } } ``` 4. 重新启动 Claude 桌面应用程序。您应该看到一个小“插件/锤子”图标，告诉您 35+ 个 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](https://huggingface.co/black-forest-labs/FLUX.1-schnell)**，创建一个免费的 Hugging Face 帐户，然后点击 **同意并访问**。 2. 进入 **[Hugging Face Tokens](https://huggingface.co/settings/tokens)** 并生成一个新的 **读取** token。 3. 打开您的 Mac 终端，激活您的虚拟环境并登录： ```bash 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 连接被拒绝** 您的 AI 大脑离线！确保您物理双击了计算机上的 **Ollama.app**。如果小骆驼图标未出现在您的菜单栏/任务栏中，本地推理将立即失败。 - **ModuleNotFoundError：没有名为 fastmcp 的模块** 您忘记激活您的虚拟环境。您不能直接启动一个全新的终端并运行 `python server.py`。您必须导航到文件夹并运行 `source venv/bin/activate`（Mac）或 `venv\Scripts\activate`（Windows）。 - **无效 JSON：期望值在第 1 行** Python 运行 MCP 服务器的终端正在用原始机器代码（JSON-RPC）进行通信。您不能在终端窗口中输入纯英文。启动后，请单独保留它。打开 Claude Desktop 或 Cursor 与其聊天。 --- ## 技术架构（适用于开发者） 此 MCP 服务器通过 [模型上下文协议](https://modelcontextprotocol.io) 标准公开您的本地 NFT 灵魂。 **资源** （您的 AI 可以访问的只读上下文）： - `soul://personality` — 五大性格评分，原型，策略，致命缺陷 - `soul://system-prompt` — 定义代理的完整系统提示 - `soul://memory` — 持久内存（交易历史，观察） - `soul://predictions` — 具有等级的预测账本 **核心工具** （您的 AI 可以调用的 35+ 个函数）： - `grade_tcg_card` — 3 阶段 PSA/Beckett 评级：Qwen Vision LLM + OpenCV 定心 + BGS 盖章 - `card_forecast` — **免费** 一次调用一致性 30 天预测 + 安全持有/动量字母评级 + 纯英文读数（传递卡片名称或 TCGplayer 产品 ID） - `monte_carlo_simulation` — 价格预测：默认一致性校准风险（诚实 VaR/CVaR + 安全持有/动量等级）；蒙特卡罗 GBM/Merton 可选 - `search_ebay_market` — 实时 eBay 市场深度，价格分布，套利检测 - `purchase_undesirables_license_key` — M2M 购买桥（EVM 交易有效载荷） - `verify_soul_initialization` — 链上灵魂验证 - `generate_voice` — Kokoro TTS 语音合成 - `generate_3d_object` — Shap E 文本转 3D 网格（.glb） - `generate_image` — 本地 FLUX 图像生成 - `web_search` — DuckDuckGo 即时答案 - `run_security_audit` — SAST 代码扫描 - `query_ollama` — 发送提示到本地 Ollama - `analyze_market` — 以角色运行市场分析 - `create_content` — 以角色编写推文，线程，生物 - `meme_machine` — 生成迷因概念和营销内容 - 还有 20 多个涵盖视频，音频，内存，沙盒执行 ``` ┌─────────────────────────────────────────────┐ │ MCP 客户端（Cursor，Claude） │ └──────────────────┬──────────────────────────┘ │ JSON-RPC（stdio） ┌──────────────────▼──────────────────────────┐ │ Undesirables MCP 服务器 │ │ ┌──────────┐ ┌──────────┐ ┌────────────┐ │ │ │资源 │ │ 工具 │ │ 提示 │ │ │ │SOUL.md │ │技能 │ │模板 │ │ │ │MEMORY.md │ │Ollama │ │ │ │ │ │预测 │ │分析 │ │ │ │ │ └──────────┘ └────┬─────┘ └────────────┘ │ └────────────────────┼────────────────────────┘ │ HTTP ┌────────────────────▼────────────────────────┐ │ Ollama（本地 LLM） │ │ llama3.1:8b / qwen / etc │ └─────────────────────────────────────────────┘ ``` ## 代理框架集成 ### LangChain / LangGraph ```python 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+ 工具现在可用于任何 LangChain 代理 ``` ### CrewAI ```python 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 卡片评级", tools=mcp.tools, goal="评级交易卡并运行蒙特卡罗价格模拟" ) ``` ### OpenAI 代理 SDK ```python 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 代理", instructions="您是一个具有 NFT 灵魂个性化的自主 AI 代理。", mcp_servers=[mcp_server] ) ``` ### ElizaOS（合并到官方 Monorepo） ```bash npm install plugin-undesirables ``` 插件现在是 [官方 ElizaOS monorepo](https://github.com/elizaOS/eliza/tree/develop/plugins/plugin-undesirables)（https://github.com/elizaOS/eliza/tree/develop/plugins/plugin-undesirables）的一部分（PR #7869，合并日期 2026 年 5 月 21 日）。 添加您的 `character.json`： ```json { "settings": { "UNDESIRABLES_WORKSPACE": "/path/to/soul_folder/0420" }, "plugins": ["plugin-undesirables"] } ``` --- ## LitVM TCG Oracle — MCP 服务器 我们还发布了一个用于 LitecoinVM 生态系统的专用链上预言机 MCP 服务器： ```bash pip install litvm-tcg-oracle ``` | 功能 | 详情 | |---------|--------| | **433K+ 交易卡** | 13 个游戏，276K 活跃定价 | | **1,300 万+ 价格观察** | 60+ 天的连续数据 | | **链上 Merkle 证明** | LitecoinForge（链 4441）上的信任最小化验证 | | **风险预测** | 一致性校准的 VaR/CVaR + 安全持有/动量评级（蒙特卡罗可选） | | **6 个 MCP 工具** | `search_cards`，`get_price_history`，`verify_price`，`oracle_status`，`simulate_price`，`grade_card` | → **GitHub**： [litvm-tcg-oracle-mcp](https://github.com/sailorpepe/litvm-tcg-oracle-mcp) → **PyPI**： [litvm-tcg-oracle](https://pypi.org/project/litvm-tcg-oracle/) → **实时预言机**： [the-undesirables.com/litvm](https://the-undesirables.com/litvm) --- ## The Undesirables 生态系统 - **网站**： [the-undesirables.com](https://the-undesirables.com) - **LitVM 预言机**： [the-undesirables.com/litvm](https://the-undesirables.com/litvm) - **铸造**: [scatter.art/the-undesirables](https://scatter.art/the-undesirables) - **文档**： [the-undesirables.com/docs](https://the-undesirables.com/docs) - **PyPI（MCP）**： [undesirables-mcp-server](https://pypi.org/project/undesirables-mcp-server/) （v1.1.8） - **PyPI（LitVM）**： [litvm-tcg-oracle](https://pypi.org/project/litvm-tcg-oracle/) （v1.0.3） - **npm**： [plugin-undesirables](https://npmjs.com/package/plugin-undesirables) （ElizaOS 插件，v2.5.0） - **Oracle API**： [oracle.the-undesirables.com](https://oracle.the-undesirables.com) （28 个端点，x402 微支付） - **awesome-mcp-servers**： [Listed ✅](https://github.com/punkpeye/awesome-mcp-servers) （85K+ ⭐） - **Glama**： [Verified ✅ 3.8/5](https://glama.ai/mcp/servers/sailorpepe/undesirables-mcp-server) - **ElizaOS 插件**： [官方 monorepo](https://github.com/elizaOS/eliza/tree/develop/plugins/plugin-undesirables) - **x402 支付服务器**： [undesirables-x402-server](https://github.com/sailorpepe/undesirables-x402-server) - **Kaggle 数据集**： [tcg-market-intelligence](https://www.kaggle.com/datasets/sailorpepe/tcg-market-intelligence) - **X**： [@undesirables_ai](https://x.com/undesirables_ai) --- ## ⚖️ 法律免责声明 **仅供娱乐目的：** 市场预言机，交易模拟器和所有 AI 生成的预测仅用于教育和娱乐目的。 AI 模型会产生幻觉，请勿使用此服务器执行实时金融交易或做出购买商业决策。 Undesirables LLC 对部署的开源 AI 工具实施零责任框架。 --- ## 📝 许可证和商业使用 该项目根据 **[商业源许可证 1.1（BUSL-1.1）](LICENSE)** 许可。 我们公开构建并支持开发者生态系统 — 但我们也保护 **The Undesirables LLC** 的基础设施和知识产权。 ### ✅ 你可以做的（免费） - **个人和教育使用** — 下载，修改并在本地或个人项目中运行以进行学习，研究或个人项目。 - **非竞争性应用** — 将我们的软件包集成到您的应用中，只要您的应用不提供 TCG 市场情报，价格聚合，AI 卡片评级或链上价格预言机服务作为其主要功能。 - **MCP / 代理集成** — 将您的 AI 代理连接到我们的工具进行非商业使用。 - **社区贡献** — 安全审计，错误修复和 PR 请求始终受欢迎。 ### 🚫 你不能做的（使用限制） - **竞争性服务** — 您不得使用此代码来运营竞争性的 TCG 市场情报，价格聚合，AI 卡片评级或链上价格预言机服务。 - **商业转售** — 您不得将我们的 API，数据管道或 AI 模型包装成付费服务。 - **托管 SaaS** — 您不得在未经书面许可的情况下，将此软件作为服务托管给第三方。 ### 🔓 开源转换 在 **2026 年 1 月 6 日**（或每个版本的首次公开发布 4 年后），此代码自动转换为 **MIT 许可证** — 完全开源，永久。 ### 🤝 商业许可 正在构建商业产品？需要保证的 API 访问或白标集成？联系我们： 📧 **theundesirables7@gmail.com** · 🐦 **[@undesirables_ai](https://x.com/undesirables_ai)** © 2026 The Undesirables LLC --- <div align="center"> ⭐ 如果这个项目对你有帮助，请在这个仓库上点赞 — 它帮助其他人发现它。 [报告 Bug](../../issues) · [请求功能](../../issues) </div>