Back to MCP directory
publicPublicdnsLocal runtime

aoirint_mcping_server

一个用于监控Minecraft服务器状态的工具,支持Bedrock和Java版本,提供Web API接口和数据库持久化功能。

article

README

🚀 aoirint_mcping_server

本项目可监控多个Minecraft Bedrock/Java服务器的状态,使用PostgreSQL数据库持久化数据,并提供带有读写API密钥身份验证的Web API。

✨ 主要特性

  • 监控多个Minecraft Bedrock/Java服务器的状态。
  • 使用PostgreSQL数据库持久化数据。
  • 带有读写API密钥身份验证的Web API。

📦 安装指南

Docker Compose

将以下文件复制到新目录中并进行配置:

  • docker-compose.yml
  • template.env -> .env

启动Docker Compose服务:

docker compose up -d

然后,应用数据库迁移

📚 详细文档

支持的Minecraft服务器版本

  • Bedrock 1.20.x
  • Java 1.20.x

Docker 仓库

数据库迁移

此仓库使用 golang-migrate。 要应用迁移,执行以下命令:

docker compose run --rm migrate -path=/migrations -database="postgres://postgres:postgres_password@postgres:5432/postgres?sslmode=disable" up

库管理

  • Python 3.12 此仓库使用 Poetry

代码格式

poetry run ruff check --fix
poetry run ruff format

poetry run mypy .
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client