返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端