Rust MCP Schema

🚀 Rust MCP Schema プロジェクトドキュメント

rust-mcp-schema は、Minecraft Bedrock Edition (BE) と Java Edition (JE) のために MCP (MineCraft Forge の公式逆コンパイラ) スキーマのサポートを提供する Rust ライブラリです。このライブラリは、開発者が 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 開発者に便利なツールとなり、コミュニティの発展に貢献することを願っています。