Rust MCP Schema

🚀 Rust MCP Schema 項目文檔

rust-mcp-schema 是一個強大的 Rust 庫，專為 Minecraft Bedrock Edition (BE) 和 Java Edition (JE) 提供 MCP (MineCraft Forge 的官方反編譯器) 模式支持。它能幫助開發者更輕鬆地處理 Minecraft 遊戲內的數據結構和協議，提升開發效率。

🚀 快速開始

rust-mcp-schema 庫助力開發者高效處理 Minecraft 遊戲內數據。下面通過具體示例展示如何使用該庫。

✨ 主要特性

• MCP Schema 支持：該庫完整實現了 MCP Schema 格式的定義，允許用戶藉助易讀的 JSON 文件描述 Minecraft 的遊戲內類型。
• 自動生成 Rust 類型：基於 MCP Schema，能夠自動生成對應的 Rust 數據結構，讓處理 Minecraft 數據變得更加直觀和高效。
• 反編譯器支持：具備解析 Minecraft 反編譯器輸出數據的能力，有助於開發者分析和理解遊戲內部的工作機制。

💻 使用示例

基礎用法

示例 1: 定義一個簡單的 MCP Schema

{
    "type": "object",
    "name": "Position",
    "fields": [
        { "type": "int", "name": "x" },
        { "type": "int", "name": "y" },
        { "type": "int", "name": "z" }
    ]
}

生成的 Rust 結構體：

#[derive(Debug, Clone)]
pub struct Position {
    pub x: i32,
    pub y: i32,
    pub z: i32,
}

示例 2: 反編譯 Minecraft 數據

假設我們有一個 MCP 反編譯後的數據文件，例如：

{
    "id": 15,
    "jsonrpc": "2.0",
    "result": {
        "capabilities": {
            "prompts": { "listChanged": true },
            "resources": { "listChanged": true, "subscribe": true },
            "tools": { "listChanged": true }
        },
        "instructions": "mcp server instructions....",
        "_meta": { "feature-xyz": true, "meta 1": "meta-value", "meta 2": 225 },
        "protocolVersion": "2024-11-05",
        "serverInfo": {
            "name": "example-servers/everything",
            "version": "1.0.0"
        }
    }
}

使用 rust-mcp-schema 進行解析：

let json_payload = message.to_string();
// 解析 JSON 數據
let mcp_message: JsonrpcMessage = serde_json::from_str(&json_payload)?;

match mcp_message {
    JsonrpcMessage::Response(response) => {
        // 處理響應數據
        if let Some(server_info) = response.result.serverInfo {
            println!("Server name: {}", server_info.name);
            println!("Server version: {}", server_info.version);
        }
    },
    _ => {}
}

📚 詳細文檔

貢獻指南

我們熱烈歡迎社區的貢獻！如果你有任何問題或建議，請隨時提交 Issues 或 Pull Requests。

提交代碼前的要求：

1. 格式檢查：確保所有 Rust 代碼遵循 Rust 的編碼規範（例如：cargo fmt --all）。
2. 單元測試：在提交代碼之前，運行項目的所有單元測試以確保沒有引入錯誤。
3. 文檔更新：如果你的更改影響了 API 或功能，請相應地更新相關的文檔和註釋。

項目結構

• schemas：包含 MCP Schema 的定義文件。
• src：包含 Rust 庫的核心實現，包括反編譯器支持、類型生成等模塊。
• examples：提供了一些使用示例，幫助用戶理解如何使用該庫。
• Cargo.toml：項目依賴管理和構建配置。

📄 許可證

該項目遵循 MIT 許可證。請查看 LICENSE 文件以獲取詳細信息。

感謝你對 rust-mcp-schema 的興趣和支持！希望這個庫能為 Minecraft 開發者提供便利，並促進社區的發展。