MCP Forge - Minecraft MCP Bridge

MCP Forge is a full admin MCP (Model Context Protocol) bridge for Minecraft. It exposes a rich set of MCP tools so any AI can read game state, control players/NPCs, build structures, mine, manage world rules, and run server commands.

Key Features

Full admin command execution via MCP.
Structured tools for players, entities, blocks, world, recipes, inventories, NPCs, and more.
NPC companion with follow/move/mine/build/combat and inventory UI.
World control: time, weather, gamerules, worldborder, biome/structure locate.
Events stream for chat, commands, spawns, deaths, and block changes.

Connection (MCP HTTP)

Endpoint: http://127.0.0.1:8765/mcp
Method: POST
Authorization: Bearer <token> (default: changeme)

MCP Tools (Summary)

Core: mc_command, mc_command_batch, mc_chat_send, mc_chat_recent
Players: mc_player_pos, mc_player_tp, mc_player_give, mc_player_gamemode, mc_player_heal, mc_player_inventory, mc_player_inventory_clear, mc_players_list
Items/Recipes: mc_list_items, mc_get_item, mc_item_search, mc_list_recipes, mc_recipe_get
World: mc_world_setblock, mc_world_fill, mc_world_replace, mc_world_structure, mc_world_time_get/set, mc_world_weather_get/set, mc_world_biome_at, mc_worldborder_get/set
Build: mc_build_plan, mc_blockstate_get, mc_blockstate_set, mc_blockstate_set_nbt
Entities: mc_entity_spawn, mc_entity_list, mc_entity_kill, mc_entity_get, mc_entity_tp, mc_entity_remove
Entity Effects/Attributes/AI: mc_entity_effects, mc_entity_effect_add/clear, mc_entity_attribute_get/set, mc_entity_ai_set
Scoreboard: objectives/teams/scores/list/display helpers
Gamerules: mc_gamerule_list/get/set
Datapacks/Functions: mc_datapack_list/enable/disable, mc_function_list/run
Advancements/Loot: mc_advancement_list/grant/revoke, mc_loot_give/spawn
NPC: mc_npc_spawn/despawn/move/follow/stop/status, mc_npc_build, mc_npc_mine, mc_npc_combat, mc_npc_creative, mc_npc_schem_load
Discovery: mc_list_biomes, mc_list_structures, mc_list_effects, mc_list_attributes, mc_list_tags
Events: mc_events_recent, resources read via mc://events/recent

Full MCP Tools List

mc_command
mc_command_batch
mc_chat_send
mc_chat_recent
mc_events_recent
mc_list_items
mc_get_item
mc_item_search
mc_list_recipes
mc_recipe_get
mc_player_pos
mc_player_tp
mc_player_give
mc_player_gamemode
mc_player_heal
mc_players_list
mc_player_inventory
mc_player_inventory_clear
mc_world_setblock
mc_world_fill
mc_world_replace
mc_world_structure
mc_world_time_get
mc_world_time_set
mc_world_weather_get
mc_world_weather_set
mc_world_biome_at
mc_worldborder_get
mc_worldborder_set
mc_locate_structure
mc_locate_biome
mc_build_plan
mc_blockstate_get
mc_blockstate_set
mc_blockstate_set_nbt
mc_nbt_get_block
mc_nbt_merge_block
mc_nbt_get_entity
mc_nbt_merge_entity
mc_nbt_get_player
mc_nbt_merge_player
mc_container_get
mc_container_set
mc_container_clear
mc_entity_spawn
mc_entity_list
mc_entity_kill
mc_entity_get
mc_entity_tp
mc_entity_remove
mc_entity_effects
mc_entity_effect_add
mc_entity_effect_clear
mc_entity_attribute_get
mc_entity_attribute_set
mc_entity_ai_set
mc_scoreboard_objectives_list
mc_scoreboard_objective_add
mc_scoreboard_objective_remove
mc_scoreboard_display_set
mc_scoreboard_display_get
mc_scoreboard_teams_list
mc_scoreboard_team_add
mc_scoreboard_team_remove
mc_scoreboard_team_join
mc_scoreboard_team_leave
mc_scoreboard_score_set
mc_scoreboard_score_get
mc_scoreboard_score_reset
mc_scoreboard_players_list
mc_scoreboard_player_scores
mc_gamerule_list
mc_gamerule_get
mc_gamerule_set
mc_datapack_list
mc_datapack_enable
mc_datapack_disable
mc_function_list
mc_function_run
mc_advancement_list
mc_advancement_grant
mc_advancement_revoke
mc_loot_give
mc_loot_spawn
mc_list_biomes
mc_list_structures
mc_list_effects
mc_list_attributes
mc_list_tags
mc_npc_spawn
mc_npc_despawn
mc_npc_move
mc_npc_follow
mc_npc_stop
mc_npc_status
mc_npc_combat
mc_npc_creative
mc_npc_build
mc_npc_mine
mc_npc_schem_load

In‑Game Commands (NPC)

/npc spawn [name] [x y z]
/npc despawn
/npc move <x> <y> <z>
/npc follow [player] [speed]
/npc stop
/npc combat <off|hostiles|players|all>
/npc creative <on|off>
/npc build wall [block] [width] [height]
/npc build bridge [block] [length] [width]
/npc build house [block] [width] [height] [depth]
/npc schem load <file> [x y z]
/npc mine line <length> [direction]
/npc mine tunnel <length> [direction]
/npc mine vein <x> <y> <z>
/npc mine ore <ore_id> [radius]
/npc status

MCP Forge - Bridge MCP pour Minecraft

MCP Forge est un bridge MCP (Model Context Protocol) full admin pour Minecraft. Il expose un large ensemble d'outils MCP afin que n'importe quelle IA puisse lire l'état du jeu, controler joueurs/NPC, construire, miner, gerer les regles du monde et executer des commandes serveur.

Fonctionnalites

Execution de commandes admin via MCP.
Outils structures pour joueurs, entites, blocs, monde, recettes, inventaires, NPC, etc.
NPC compagnon avec follow/move/mine/build/combat + inventaire.
Controle du monde: temps, meteo, gamerules, worldborder, locate biome/structure.
Flux d'évenements: chat, commandes, spawns, morts, blocs.

Connexion (MCP HTTP)

Endpoint: http://127.0.0.1:8765/mcp
Methode: POST
Authorization: Bearer <token> (par defaut: changeme)

Outils MCP (Resume)

Core: mc_command, mc_command_batch, mc_chat_send, mc_chat_recent
Joueurs: mc_player_pos, mc_player_tp, mc_player_give, mc_player_gamemode, mc_player_heal, mc_player_inventory, mc_player_inventory_clear, mc_players_list
Items/Recettes: mc_list_items, mc_get_item, mc_item_search, mc_list_recipes, mc_recipe_get
Monde: mc_world_setblock, mc_world_fill, mc_world_replace, mc_world_structure, mc_world_time_get/set, mc_world_weather_get/set, mc_world_biome_at, mc_worldborder_get/set
Build: mc_build_plan, mc_blockstate_get, mc_blockstate_set, mc_blockstate_set_nbt
Entites: mc_entity_spawn, mc_entity_list, mc_entity_kill, mc_entity_get, mc_entity_tp, mc_entity_remove
Effets/Attributs/IA: mc_entity_effects, mc_entity_effect_add/clear, mc_entity_attribute_get/set, mc_entity_ai_set
Scoreboard: objectives/teams/scores/list/display
Gamerules: mc_gamerule_list/get/set
Datapacks/Functions: mc_datapack_list/enable/disable, mc_function_list/run
Advancements/Loot: mc_advancement_list/grant/revoke, mc_loot_give/spawn
NPC: mc_npc_spawn/despawn/move/follow/stop/status, mc_npc_build, mc_npc_mine, mc_npc_combat, mc_npc_creative, mc_npc_schem_load
Discovery: mc_list_biomes, mc_list_structures, mc_list_effects, mc_list_attributes, mc_list_tags
Events: mc_events_recent, lecture via mc://events/recent

Liste complete des outils MCP

mc_command
mc_command_batch
mc_chat_send
mc_chat_recent
mc_events_recent
mc_list_items
mc_get_item
mc_item_search
mc_list_recipes
mc_recipe_get
mc_player_pos
mc_player_tp
mc_player_give
mc_player_gamemode
mc_player_heal
mc_players_list
mc_player_inventory
mc_player_inventory_clear
mc_world_setblock
mc_world_fill
mc_world_replace
mc_world_structure
mc_world_time_get
mc_world_time_set
mc_world_weather_get
mc_world_weather_set
mc_world_biome_at
mc_worldborder_get
mc_worldborder_set
mc_locate_structure
mc_locate_biome
mc_build_plan
mc_blockstate_get
mc_blockstate_set
mc_blockstate_set_nbt
mc_nbt_get_block
mc_nbt_merge_block
mc_nbt_get_entity
mc_nbt_merge_entity
mc_nbt_get_player
mc_nbt_merge_player
mc_container_get
mc_container_set
mc_container_clear
mc_entity_spawn
mc_entity_list
mc_entity_kill
mc_entity_get
mc_entity_tp
mc_entity_remove
mc_entity_effects
mc_entity_effect_add
mc_entity_effect_clear
mc_entity_attribute_get
mc_entity_attribute_set
mc_entity_ai_set
mc_scoreboard_objectives_list
mc_scoreboard_objective_add
mc_scoreboard_objective_remove
mc_scoreboard_display_set
mc_scoreboard_display_get
mc_scoreboard_teams_list
mc_scoreboard_team_add
mc_scoreboard_team_remove
mc_scoreboard_team_join
mc_scoreboard_team_leave
mc_scoreboard_score_set
mc_scoreboard_score_get
mc_scoreboard_score_reset
mc_scoreboard_players_list
mc_scoreboard_player_scores
mc_gamerule_list
mc_gamerule_get
mc_gamerule_set
mc_datapack_list
mc_datapack_enable
mc_datapack_disable
mc_function_list
mc_function_run
mc_advancement_list
mc_advancement_grant
mc_advancement_revoke
mc_loot_give
mc_loot_spawn
mc_list_biomes
mc_list_structures
mc_list_effects
mc_list_attributes
mc_list_tags
mc_npc_spawn
mc_npc_despawn
mc_npc_move
mc_npc_follow
mc_npc_stop
mc_npc_status
mc_npc_combat
mc_npc_creative
mc_npc_build
mc_npc_mine
mc_npc_schem_load

Commandes en jeu (NPC)

/npc spawn [nom] [x y z]
/npc despawn
/npc move <x> <y> <z>
/npc follow [joueur] [vitesse]
/npc stop
/npc combat <off|hostiles|players|all>
/npc creative <on|off>
/npc build wall [bloc] [largeur] [hauteur]
/npc build bridge [bloc] [longueur] [largeur]
/npc build house [bloc] [largeur] [hauteur] [profondeur]
/npc schem load <fichier> [x y z]
/npc mine line <longueur> [direction]
/npc mine tunnel <longueur> [direction]
/npc mine vein <x> <y> <z>
/npc mine ore <ore_id> [radius]
/npc status