Skip to main content
Glama
deenesjakoruzh
MCNeteaseDevs

NetEase ModSDK MCP Server

by MCNeteaseDevs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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: MCP SpecNavigator

🚀 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 组件的详细用法

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers