de en es ja ko ru zh

NetEase ModSDK MCP Server

Name: NetEase ModSDK MCP Server
Author: MCNeteaseDevs

by MCNeteaseDevs

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

🎮 NetEase ModSDK MCP Server

Model Context Protocol Server für die Entwicklung von 我的世界中国版（网易）ModSDK

Bietet KI-Programmierassistenten versionsbasierte Entwicklungsanleitung, offizielle Dokumentationssuche, Artefaktgenerierung und einheitliche Validierung für ModSDK 3.9 / BE 1.21.120. Läuft vollständig offline und liest nur Snapshots im Repository.

✨ Kernfunktionen

Funktion	Beschreibung
🔍 Intelligente Dokumentsuche	Fuzzy-Suche, CamelCase-Tokenisierung, chinesische Suche, abdeckt API-Schnittstellen & Ereignisdokumentation
📝 Codegenerierung	Automatische Generierung von Mod-Projekten, Server/Client-Systemen, benutzerdefinierten Gegenständen/Blöcken/Entitäten gemäß NetEase-Standards
🔧 Tool- & Waffengenerierung	Ein-Klick-Generierung von Schwert, Spitzhacke, Axt, Schaufel, Hacke, Bogen, Rüstung, Nahrung, werfbaren Gegenständen als JSON
📋 Rezepte & Beutetabellen	Generierung von geordneten/ungeordneten Crafting-Rezepten, Schmelzrezepten, Beutetabellen, Spawn-Regeln
🔬 Code-Review	Erkennung von Python-2.7-Kompatibilität, Client/Server-Vermischung, Performance-Anti-Patterns
🧭 Versionsbasierte Anleitung	Regelauswahl nach Ziel, Bereich und Endseite, mit Quellenstufe und 3.9-Evidenzgrenzen
📚 Komponenten-Enzyklopädie	Abfrage von Verwendung und Konfiguration für Gegenstands-/Block-/Entitäts-/NetEase-spezifische Komponenten
⚡ Best Practices	Projektion offizieller Regeln, MCP-Strategien und begrenzter Engineering-Empfehlungen aus dem versionsbasierten Register

Related MCP server: codeglance-mcp

🚀 Schnellstart

Voraussetzungen

Python ≥ 3.10
pip (Python-Paketmanager)

1. Abhängigkeiten installieren

cd "<PROJECT_ROOT>"
pip install -r requirements.txt

2. Wähle deinen KI-Client für die Konfiguration

Allgemeiner Hinweis: Alle Clients starten einheitlich über den absoluten Pfad von start_mcp.py, ohne cwd-Parameter, für beste Kompatibilität. Ersetze <PROJECT_ROOT> in den folgenden Beispielen durch den Projektstammordner auf deinem Rechner.

Konfigurationsdatei bearbeiten:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "modsdk-mcp-server": {
      "command": "python",
      "args": ["<PROJECT_ROOT>/start_mcp.py"]
    }
  }
}

Nach dem Speichern Claude Desktop neu starten.

Claude Code unterstützt den cwd-Parameter nicht; verwende einfach den absoluten Pfad von start_mcp.py:

claude mcp add "modsdk-mcp-server" -- python "<PROJECT_ROOT>/start_mcp.py"

Oder bearbeite manuell ~/.claude/settings.json:

{
  "mcpServers": {
    "modsdk-mcp-server": {
      "command": "python",
      "args": ["<PROJECT_ROOT>/start_mcp.py"]
    }
  }
}

Erstelle .cursor/mcp.json (Cursor) oder .vscode/mcp.json (VS Code) im Projektstammordner:

{
  "servers": {
    "modsdk-mcp-server": {
      "command": "python",
      "args": ["<PROJECT_ROOT>/start_mcp.py"]
    }
  }
}

⚠️ Häufiges Problem (VS Code / Cursor)
Wenn beim Starten des MCP in VS Code oder Cursor der folgende Fehler auftritt:
Error: tool parameters array type must have items
Ursache:
Im Parameter-Schema der MCP-Tools sind einige Felder als "type": "array" deklariert, ohne ein "items"-Feld anzugeben.
Gemäß JSON-Schema-Spezifikation müssen alle Array-Typen "items" definieren, sonst tritt in strikten Validierungsumgebungen (wie VS Code / Cursor) ein Fehler auf.
Lösung:
Ändere die Parameterdefinition des entsprechenden Tools, zum Beispiel:
❌ Falsche Schreibweise:
{
  "type": "array"
}
✅ Richtige Schreibweise:
{
  "type": "array",
  "items": {
    "type": "object"
  }
}

SSE-Dienst starten:

python "<PROJECT_ROOT>/start_mcp.py" --sse
# 默认监听 http://0.0.0.0:8000

Im Client konfigurieren:

{
  "mcpServers": {
    "modsdk-mcp-server": {
      "transport": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

3. Verbindung prüfen

Gib im KI-Assistenten den folgenden Testbefehl ein:

搜索 GetEngineCompFactory 的用法

Wenn API-Dokumentinhalte zurückgegeben werden, ist der MCP Server erfolgreich verbunden.

📖 Übersicht der MCP-Tools

Dokumentabfrage

Tool	Beschreibung
`search_docs`	Dokumente durchsuchen (unterstützt Fuzzy-Matching, CamelCase-Tokenisierung, Chinesisch)
`search_api`	Strukturierten API-/Ereignisindex durchsuchen
`get_api_detail`	Signatur, Anmerkungen, Beispiele und Quellmetadaten gleichnamiger Multi-End-APIs/Ereignisse lesen
`get_document`	Vollständigen Inhalt eines angegebenen Dokuments abrufen
`get_document_section`	Angegebenen Abschnitt eines Dokuments abrufen
`get_document_structure`	Inhaltsverzeichnisstruktur eines Dokuments abrufen
`list_documents`	Alle verfügbaren Dokumente auflisten
`reload_documents`	Dokumentindex neu laden
`get_development_guidance`	Relevanteste Regeln und Validierungsempfehlungen nach Ziel, Bereich, Endseite und Version zurückgeben

Codegenerierung

Tool	Beschreibung
`generate_mod_project`	Vollständige Mod-Projektvorlage generieren (mit Einstieg, Server, Client)
`generate_server_system`	Server-Systemcode generieren
`generate_client_system`	Client-Systemcode generieren
`generate_event_listener`	Ereignis-Listener-Code generieren
`generate_custom_command`	Benutzerdefinierten Befehls-Code generieren
`generate_custom_item`	Benutzerdefinierten Gegenstandscode und JSON generieren
`generate_custom_block`	Benutzerdefinierten Blockcode und JSON generieren

JSON-Generierung

Tool	Beschreibung
`generate_item_json`	Gegenstands-JSON generieren (Verhaltenspaket + Ressourcenpaket)
`generate_block_json`	Block-JSON generieren
`generate_recipe_json`	Crafting-Rezept-JSON generieren (geordnet/ungeordnet/Schmelzen)
`generate_entity_json`	Entitäts-JSON generieren (Verhaltenspaket + Ressourcenpaket)
`generate_loot_table_json`	Beutetabellen-JSON generieren
`generate_spawn_rules_json`	Spawn-Regeln-JSON generieren

Ein-Klick-Tool- & Waffengenerierung

Tool	Beschreibung
`generate_sword_json`	Benutzerdefiniertes Schwert (Schaden, Haltbarkeit, Verzauberung, Reparatur)
`generate_pickaxe_json`	Benutzerdefinierte Spitzhacke (Abbaugeschwindigkeit, Haltbarkeit)
`generate_axe_json`	Benutzerdefinierte Axt (Schaden, Abbaugeschwindigkeit)
`generate_shovel_json`	Benutzerdefinierte Schaufel
`generate_hoe_json`	Benutzerdefinierte Hacke
`generate_bow_json`	Benutzerdefinierter Bogen (Spannzeit, Haltbarkeit)
`generate_food_json`	Benutzerdefinierte Nahrung (Hungerwert, Sättigung, Trankeffekte)
`generate_armor_json`	Benutzerdefinierte Rüstung (Rüstungswert, Slot)
`generate_throwable_json`	Benutzerdefinierter werfbarer Gegenstand

Code-Review & Best Practices

Tool	Beschreibung
`review_code`	Einheitliche Prüfung explizit übergebener Python/JSON-Artefakte
`get_best_practices`	Alte Schnittstellen-kompatible Projektion der Registerregeln
`search_components`	Bedrock-Komponenten durchsuchen
`get_component_details`	Detaillierte Komponenteninformationen abrufen
`list_components`	Alle verfügbaren Komponenten auflisten
`get_architecture_pattern`	Kernarchitektur-Beispiele abrufen und validieren

📂 Projektstruktur

ModSDK MCP Server/
├── modsdk_mcp/                     # MCP Server 核心模块
│   ├── __init__.py                 # 包标识
│   ├── __main__.py                 # python -m 入口
│   ├── server.py                   # MCP Server 主程序（工具注册、请求处理）
│   ├── docs_reader.py              # 文档读取与搜索引擎
│   ├── standards.py                # 严格加载版本化规范注册表
│   ├── guidance.py                 # 规则筛选与稳定 guidance JSON
│   ├── validation.py               # Python/JSON 统一产物校验
│   ├── knowledge_base.py           # 组件知识库 & 最佳实践兼容投影
│   └── templates.py                # 代码模板 & JSON 生成器
├── docs/                           # ModSDK 官方文档（Markdown）
│   ├── 接口/                       #   API 接口文档
│   ├── 事件/                       #   事件文档
│   ├── 枚举值/                     #   枚举值文档
│   └── 更新信息/                   #   版本更新日志
├── standard/registry/              # 唯一规范源、版本配置与白名单快照
├── skills/                         # 兼容说明；不作为运行时规范源
├── start_mcp.py                    # Agent专用启动入口
├── .mcp.json                       # MCP 配置
├── requirements.txt                # Python 依赖
├── Dockerfile                      # Docker 镜像配置
├── docker-compose.yml              # Docker Compose 配置
├── DEPLOYMENT.md                   # 详细部署指南
└── README.md                       # 本文件

⚙️ Umgebungsvariablen

Variablenname	Beschreibung	Standardwert
`MODSDK_DOCS_PATH`	Pfad zum ModSDK-Dokumentationsverzeichnis	`./docs`
`MCP_HOST`	SSE-Modus-Listenadresse	`0.0.0.0`
`MCP_PORT`	SSE-Modus-Listenport	`8000`

🎯 Integrierte Codestandards

Die Generatoren des MCP Servers durchlaufen einheitlich eine strukturbewusste Validierung. Nur nachweislich schwere Verstöße sowie vom Projekt ausdrücklich verbotene String-Präfixe blockieren; Performance-, JSON-UI- und Lebenszyklus-Engineering-Empfehlungen erzeugen standardmäßig Warnungen oder erfordern manuelle Bestätigung.

Standard	Beschreibung
Client/Server-Trennung	ServerSystem darf kein `clientApi` importieren und umgekehrt
Python-2.7-Kompatibilität	Echte `u/U/ur/ru`-String-Präfixe und Python-3-spezifische Syntax verboten; Dateien enthalten UTF-8-Deklaration
Präzise Import-Whitelist	Verwendet die 456 offiziellen Snapshots im Repository; Projektmodule müssen explizit deklariert werden
Kontextbezogene Performance-Warnungen	Hinweise auf Spam, wiederholte Erstellung oder Frequenzreduzierung nur bei ausreichendem Kontext in Schleifen, Ticks oder hochfrequenten Ereignissen
Punkt-zu-Punkt-Kommunikation	`NotifyToClient` bevorzugen, `BroadcastToAllClient` sparsam verwenden
JSON-Formatstufen	Basisgegenstände 1.10; Blöcke unterstützen legacy_1_10, scalar_1_16, modern_1_19_20

standard/registry/ ist die einzige Normquelle. Bevorzugt get_development_guidance verwenden; get_best_practices dient nur als Kompatibilitätsprojektion.

📝 Verwendungsbeispiele

Mod-Projekt generieren

帮我创建一个名为"传送系统"的 Mod，ID 为 teleport_sys，功能是让玩家通过命令传送到指定位置

Benutzerdefiniertes Diamantschwert generieren

帮我生成一把自定义钻石剑，命名空间 mymod，ID 为 diamond_blade，攻击力 10，耐久 500

Code-Review

帮我审查这段代码：

def OnTick(self):
    import mod.server.extraServerApi as serverApi
    comp = serverApi.GetEngineCompFactory().CreatePos(self.playerId)
    pos = comp.GetPos()

Komponentenverwendung abfragen

搜索 minecraft:food 组件的详细用法

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Maintenance

ActivityMaintained

ResponsivenessLimited data

Resources

Related MCP Connectors

mcp
dev.augments
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Developer Tools Documentation Access
2127
https://mcp.augments.dev/mcp
Duck Framework MCPA
io.github.duckframework
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
Developer Tools Coding Agents
13145
https://duckframework.com/mcp
Gessa: game asset generation for AI agents
ai.gessa
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
AI & Machine Learning Image & Video Processing Audio Processing
1
https://api.gessa.ai/mcp/rpc
dev
io.github.doc2mcp
MCP server for dev documentation, generated by doc2mcp.
Documentation Access Developer Tools
12
https://www.doc2mcp.site/api/mcp/a21ddb4d-2344-4869-a191-162e1ebea375/mcp

Related MCP Servers

MCP Documentation Server
Documentation Access Developer Tools Search
glassBead-tc
A
license
B
quality
D
maintenance
Provides comprehensive access to MCP documentation through structured guides, full-text search, and interactive development workflows for building servers and clients.
Updated a year ago (2025-09-19 13:06 UTC)
3
43 npm
MIT
codeglance-mcp
Version Control Code Analysis AI & Machine Learning
lucidopus
A
license
A
quality
D
maintenance
Analyzes GitHub repositories using Gemini AI and generates comprehensive documentation including overviews, architecture guides, and file insights. Works with any MCP-compatible client.
Updated 8 months ago (2026-03-21 23:42 UTC)
3
MIT
mcp-server-minecraft-mod
Documentation Access Games & Gamification
Zhou-Shilin
A
license
A
quality
D
maintenance
Provides access to Minecraft mod development documentation (Neoforge) via MCP tools, allowing users to list providers and versions, browse file structures with previews, and retrieve full document content.
Updated 2 years ago (2025-05-04 13:51 UTC)
3
6
Apache 2.0
ultimate-construct3-mcp
Developer Tools Games & Gamification Documentation Access
nahuelgallo
A
license
A
quality
D
maintenance
Unified MCP server for Construct 3 providing offline documentation, project read/write, analysis, and scripting support. Enables AI-driven game development and project management through natural language.
Updated 8 months ago (2026-03-16 07:03 UTC)
6
1
MIT