MMCP

RispyCZ/MMCP

3.1

If you are the rightful owner of MMCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Model Context Protocol (MCP) server is designed to facilitate the integration of Large Language Models (LLMs) with various applications, providing a structured way to automate and enhance tasks through AI capabilities.

Tools
3
Resources
0
Prompts
0

MMCP (Minecraft MCP)

🚧 Work in Progress - Early Development Stage

MMCP is a Minecraft plugin that implements the Model Context Protocol (MCP) server, enabling Large Language Models (LLMs) to assist with server administration tasks. This plugin bridges the gap between AI assistants and Minecraft server management, automating boring administrative work.

✨ Features

Currently available MCP tools:

  • read_file - Read server configuration files and logs
  • write_file - Modify configuration files and create new ones
  • send_command - Execute server commands programmatically

What can LLMs help with?

  • Server configuration management
  • Log file analysis and monitoring
  • Automated command execution
  • Configuration troubleshooting
  • Routine administrative tasks

🔧 Installation

  1. Download the latest release from the page
  2. Place MMCP-x.x.x.jar in your server's plugins/ directory
  3. Restart your server
  4. Configure the plugin (see Configuration section)

📋 Requirements

  • Minecraft Version: 1.21.x
  • Server Software: Paper
  • Java Version: 17+

⚙️ Configuration

After first run, edit plugins/MMCP/main.conf:

plugin {
    http {
        address="0.0.0.0"
        port=8090
        apiToken="<Random API Token>"
        whitelistedIps=[]
    }
}

🚀 Usage

Connecting an LLM Client

  1. Start your Minecraft server with MMCP installed
  2. Connect your MCP-compatible LLM client to http://localhost:8090
  3. Authenticate using your configured API key
  4. Start using the available tools!

🛠️ Available MCP Tools

read_file

Read contents of server files

  • Parameters: path (string) - File path relative to server directory
  • Returns: File contents as text

write_file

Write or modify server files

  • Parameters:
    • path (string) - File path relative to server directory
    • content (string) - Content to write
  • Returns: Success confirmation

send_command

Execute server console commands

  • Parameters: command (string) - Command to execute (without /)
  • Returns: Command output/result

🔒 Security Considerations

  • Authentication: API key required for all requests

🗺️ Roadmap

Planned features for future releases:

🤝 Contributing

This project is open source and contributions are welcome!

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

This project is licensed under the - see the COPYING file for details.

🐛 Bug Reports & Feature Requests

Please use the page to:

  • Report bugs
  • Request new features
  • Ask questions about usage

⚠️ Disclaimer

This plugin is in active development. Features may change, and there might be bugs. Use in production environments at your own risk. Always backup your server before testing new versions.

📞 Support

  • Issues:
  • Discussions:

Made with ❤️ for the Minecraft community