Donut Smp MCP

DonutSMP MCP服务器

用于DonutSMP公共API的MCP（模型上下文协议）服务器。该服务器提供对所有DonutSMP API端点的访问，包括拍卖行、排行榜、玩家查找、统计数据和盾牌配置。

🚀 部署选项： 本地（STDIO/HTTP/SSE）| Vercel（无服务器）| Docker（即将推出）

特性

• 拍卖行：列出当前拍卖条目和交易历史
• 排行榜：访问10个不同的排行榜（杀戮、死亡、金钱、游戏时间、区块等）
• 玩家查询：获取与以下类似的玩家信息 /findplayer 命令
• 球员统计：检索详细的玩家统计数据，如 /stats 命令
• 盾牌管理：获取并更新Java和Bedrock服务的Shield配置
• 屏蔽监控：访问服务指标和统计数据

部署选项

🚀 部署到Vercel（建议用于生产）

在Vercel上部署为无服务器REST API：

vercel

看 VERCEL_DEPLOY.md 获取完整的部署指南。

💻 本地安装

1. 安装依赖项：

pip install -r requirements.txt

1. 将DonutSMP API密钥设置为环境变量：

# Windows (PowerShell)
$env:DONUTSMP_API_KEY = "your_api_key_here"

# Windows (Command Prompt)
set DONUTSMP_API_KEY=your_api_key_here

# Linux/Mac
export DONUTSMP_API_KEY=your_api_key_here

若要获取API密钥，请使用 /api DonutSMP上的游戏内命令。

用法

运行服务器

服务器支持三种传输模式：

1.STDIO模式（默认-适用于克劳德桌面）

python main.py
# or explicitly
python main.py --mode stdio

2.SSE模式（服务器发送事件）

python main.py --mode sse --host 127.0.0.1 --port 8000

SSE端点将在以下位置可用： http://127.0.0.1:8000/sse

3.HTTP模式（REST API）

python main.py --mode http --host 127.0.0.1 --port 8000

REST API将在以下网址提供： http://127.0.0.1:8000

命令行选项

• --mode -运输方式： stdio, sse，或 http （默认值： stdio)
• --host -用于SSE/HTTP模式的绑定主机（默认值： 127.0.0.1)
• --port -SSE/HTTP模式的绑定端口（默认值： 8000)

HTTP模式REST端点

在HTTP模式下运行时，以下REST端点可用：

• GET /health -健康检查
• GET /tools -列出所有可用工具
• GET /auction/list/{page} -拍卖行列表
• GET /auction/transactions/{page} -拍卖交易
• GET /leaderboards/{type}/{page} -排行榜（类型：断块、死亡、杀戮、移动技能、金钱、地点块、游戏时间、出售、碎片、商店）
• GET /lookup/{user} -玩家查询
• GET /stats/{user} -玩家统计
• GET /shield/{platform}/config/{service} -Shield配置（平台：java/brocket）
• GET /shield/metrics/{service} -屏蔽指标
• GET /shield/stats/{service} -盾牌统计数据

HTTP请求示例：

# Health check
curl http://127.0.0.1:8000/health

# Get player stats
curl http://127.0.0.1:8000/stats/Notch

# Get money leaderboard page 1
curl http://127.0.0.1:8000/leaderboards/money/1

使用Claude Desktop进行配置

添加到您的Claude Desktop配置文件中：

视窗: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "donutsmp": {
      "command": "python",
      "args": [
        "d:\\ai playground\\mcp_donut\\main.py"
      ],
      "env": {
        "DONUTSMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

拍卖

• auction_list -获取当前拍卖行条目（分页）
• auction_transactions -获取拍卖行交易历史记录（分页）

排行榜

• leaderboard_broken_blocks -阻止破碎的排行榜
• leaderboard_deaths -死亡排行榜
• leaderboard_kills -杀死排行榜
• leaderboard_mobs_killed -暴徒杀害排行榜
• leaderboard_money -金钱排行榜
• leaderboard_placed_blocks -块放置排行榜
• leaderboard_playtime -游戏时间排行榜
• leaderboard_sell -排行榜上/卖出的金额
• leaderboard_shards -碎片排行榜
• leaderboard_shop -在/商店排行榜上花费的金额

玩家信息

• lookup_player -按用户名或UUID查找玩家
• player_stats -获取详细的玩家统计数据

盾牌（管理员）

• shield_bedrock_config_get -获取基岩盾牌配置
• shield_bedrock_config_update -更新基岩防护配置
• shield_java_config_get -获取Java Shield配置
• shield_java_config_update -更新Java Shield配置
• shield_metrics -获取Shield服务指标
• shield_stats -获取Shield服务统计数据

API 参考

基本URL: https://api.donutsmp.net/v1

速率限制：每个API密钥每分钟250个请求

有关API的完整文档，请访问：https://api.donutsmp.net/index.html

例子

查看玩家统计信息

Can you show me the stats for player "Notch"?

查看排行榜

What are the top players on the money leaderboard?

拍卖行

Show me the current auction house listings on page 1

许可证

本项目根据GUN GPL.3许可证获得许可。看 许可证 了解详情。