trackmcp
Back to directory
GeyserMC

mcprotocollib

View on GitHub

A library for communication with a Minecraft client/server. Built for the Model Context Protocol to enhance AI capabilities. Java-based implementation.

856 stars JavaDeveloper Kits Updated Nov 1, 2025
javalibraryminecraftminecraft-protocolprotocol

Documentation

MCProtocolLib

MCProtocolLib is a simple library for communicating with Minecraft clients and servers. It allows developers to build custom bots, clients, or servers for Minecraft with ease.

Example Code

See the example folder for sample usage.

Adding as a Dependency

MCProtocolLib builds are published to the Open Collaboration repository.

Follow the below steps to add MCProtocolLib as a dependency to your project.

Maven

Add the Repository

xml
opencollab
        https://repo.opencollab.dev/main/

Add the Dependency

xml
org.geysermc.mcprotocollib
    protocol
    (version here)

Gradle (Groovy DSL)

Add the Repository

groovy
repositories {
    maven { 
        name 'opencollab'
        url 'https://repo.opencollab.dev/main/'
    }
}

Add the Dependency

groovy
dependencies {
    implementation 'org.geysermc.mcprotocollib:protocol:(version here)'
}

Gradle (Kotlin DSL)

Add the Repository

kotlin
repositories {
    maven("https://repo.opencollab.dev/main/") {
        name = "opencollab"
    }
}

Add the Dependency

kotlin
dependencies {
    implementation("org.geysermc.mcprotocollib:protocol:(version here)")
}

Snapshots

To use snapshot builds, switch the URL to `https://repo.opencollab.dev/maven-snapshots/`.

Javadocs

You can find the Javadocs for MCProtocolLib on opencollab.

Building the Source

MCProtocolLib uses Gradle to manage dependencies. To build the source code, run `./gradlew clean build` in the project root directory.

Support and Development

Please join the GeyserMC Discord server and visit the #mcprotocollib channel for discussion and support for this project.

License

MCProtocolLib is licensed under the **MIT license**.

Frequently asked questions

What is mcprotocollib?

mcprotocollib is A library for communication with a Minecraft client/server. Built for the Model Context Protocol to enhance AI capabilities. Java-based implementation.

How do I install mcprotocollib?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcprotocollib open source?

Yes — it is hosted on GitHub at https://github.com/GeyserMC/MCProtocolLib and has 856 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP