Minecraft服务器协议插件

PaperMCP

PaperMCP 是一个Minecraft Paper插件，旨在实现模型上下文协议（MCP），用于与运行PaperMC的Minecraft服务器进行接口连接。该项目的目标是提供与MCP的无缝集成，允许AI模型按照MCP规范以标准化的方式与Minecraft服务器交互。

该项目仍处于早期阶段，目前处于 贝塔因此，许多功能可能无法按预期工作或可能不完整。长期目标是尽可能地扩展插件的功能，以覆盖Minecraft服务器提供的大部分功能，允许通过外部AI模型或工具与服务器进行完全交互。

特性

• 实现 模型上下文协议（MCP） 适用于Minecraft PaperMC服务器。
• 通过标准化协议将服务器数据和功能暴露给外部系统。
• 目前在 贝塔；预计会有bug和不完整的功能。

安装

安装 PaperMCP 在您的Minecraft服务器上，按照以下简单步骤操作：

1. 下载最新 PaperMCP 插件 .jar 文件来自 这里.
2. 放置 .jar 文件在 plugins PaperMC服务器的文件夹。
3. 启动服务器。在启动时， PaperMCP 将自动初始化。

配置

安装插件后，您可以在 config.yml 文件，位于插件的文件夹中。

最重要的配置选项是 port，它定义了MCP的Streamable HTTP服务器将在其上运行的端口。您可以将其设置为服务器上的任何可用端口。此外，您还可以配置其他参数，如服务器的名称和端点URL。

将客户端连接到MCP服务器

使用 PaperMCP 从任何MCP客户端，您都需要添加一个新的MCP远程服务器，URL格式如下：

{server-ip}:{port}/{endpoint}

• {server_ip}：Minecraft服务器的IP地址。
• {port}：中定义的端口 config.yml 文件。
• {endpoint}：中配置的终结点 config.yml （默认情况下，此设置为 /mcp).

例如，如果您的服务器的IP是 127.0.0.1，端口是 15000，默认端点为 /mcp，要连接的URL为：

127.0.0.1:15000/mcp

如果您的客户端本机不支持远程服务器，请尝试使用 mcp遥控器

贡献

我们欢迎并鼓励对 PaperMCP 项目。如果您想帮助改进插件、添加新功能或修复错误，请随时分叉存储库、创建拉取请求并贡献您的更改。

鸣谢

• 它很咸。：原创想法和主要开发者。
• MCP声明式Java SDK：一个用于在Java中使用MCP的轻量级库，没有它，这个插件就不可能实现。

我们感谢MCP Declarative团队所做的工作，这对创建此插件至关重要。

许可证

本项目根据MIT许可证条款获得许可。