Skip to content

as7ar/MCPMC

Repository files navigation

MCPMC

Lightweight MCP server implementation for Minecraft plugins.

Features

  • Simple MCP server setup
  • Tool & resource registration
  • Streamable HTTP support
  • Designed for modern Minecraft plugin environments

Installation

> git clone https://github.com/as7ar/MCPMC.git

> gradlew build

Installation (via JitPack)

1. Add JitPack repository

Gradle (Kotlin)

repositories {
    maven("https://jitpack.io")
}

Gradle (Groovy)

repositories {
    maven { url 'https://jitpack.io' }
}

2. Add dependency

dependencies {
    implementation("com.github.as7ar:MCPMC:<version>")
}

Usage

Register Tool

import kr.astar.mcp.MCPMC
import kr.astar.mcpmc.utils.registeredToolGenerator
import kr.astar.mcpmc.schema.SchemaType
import kr.astar.mcpmc.utils.getParam
import kr.astar.mcpmc.utils.*

MCPMC.addTool(
    registeredToolGenerator(
        name = "hello",
        description = "Simple hello tool",
        param = mapOf(
            "name" to SchemaType.STRING
        )
    ) { req ->
        val name = req.getParam("name") ?: "world"

        "Hello, $name".toToolResult()
    }
)

Connect

MCPMC exposes a Streamable HTTP endpoint.

Use any MCP-compatible client to connect:

  • POST /mcp
  • JSON-RPC based communication

License

MIT

About

MCP Server for Minecraft

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages