MineMCP
A Minecraft Paper plugin that implements the Model Context Protocol (MCP) server, enabling AI agents to control and monitor a Minecraft 1.21 server via HTTP.
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
A Minecraft Paper plugin that implements the Model Context Protocol (MCP) server, enabling AI agents to control and monitor a Minecraft 1.21 server via HTTP.
An MCP server implementation bridging AI agents and an Minecraft server.
pose_block - Place a block at specific coordinatesbreak_block - Break a block at specific coordinatesfill_block - Fill a region with blocksexecute_command - Execute any Minecraft command with output captureread_file - Read text files from the serverwrite_file - Write text files to the serverread_file_base64 - Read binary files as Base64write_file_base64 - Write binary files from Base64list_directory - List directory contentslist_plugins - Get all installed pluginsget_logs - Retrieve recent server logsget_online_players - List all online playersget_player - Get detailed information about a specific player (health, inventory, location, effects, etc.)MineMCP-1.0.0-all.jar in your server's plugins/ folderplugins/MineMCP/config.ymlAfter the first run, edit plugins/MineMCP/config.yml:
server:
port: 3000
token: "your-secret-token-here" # Change this to a secure random token!
Important: Always change the default token for security!
# Linux/macOS
openssl rand -hex 32
# Or use any password generator to create a strong token
[MineMCP] MCP server started on port 3000Create or edit .vscode/mcp.json in your project:
{
"mcpServers": {
"minecraft": {
"url": "http://localhost:3000/sse?token=your-secret-token-here"
}
}
}
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "execute_command",
"arguments": {
"command": "time set day"
}
}
}
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "pose_block",
"arguments": {
"world": "world",
"x": 100,
"y": 64,
"z": 200,
"material": "DIAMOND_BLOCK"
}
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "get_player",
"arguments": {
"player": "PlayerName",
...
}
}
}
0.0.0.0 (all interfaces)Contributions are welcome! Please follow these steps:
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)McpTool in src/main/java/me/axeno/minemcp/tools/impl/getSchema() and execute())ToolHandler.java constructorExample:
public class MyTool extends McpTool {
public MyTool() {
super("my_tool", "Description of my tool");
}
@Override
public ObjectNode getSchema() {
ObjectNode schema = mapper.createObjectNode();
schema.put("type", "object");
// Define your schema...
return schema;
}
@Override
public ObjectNode execute(JsonNode args) throws Exception {
CompletableFuture<String> future = new CompletableFuture<>();
Bukkit.getScheduler().runTask(MineMCP.getInstance(), () -> {
try {
// Your Bukkit operations here
future.complete("Success!");
} catch (Exception e) {
future.completeExceptionally(e);
}
});
String result = future.get(10, TimeUnit.SECONDS);
return createTextResult(result);
}
}
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ for the Minecraft and AI communities
An MCP server implementation bridging AI agents and an Minecraft server.
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
MineMCP ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-05 An MCP server implementation bridging AI agents and an Minecraft server.