# GAMEMONITORING MCP

MCP（Model Context Protocol）让智能体能够查询 GAMEMONITORING 的游戏、服务器、在线状态和玩家人数。所有工具均为只读，访问公开数据无需账号或 API 密钥。

## 连接智能体

手动配置时请选择 Streamable HTTP 并粘贴此地址。Cursor 和 VS Code 支持直接安装，命令行客户端可复制安装命令。

```text
https://api.gamemonitoring.net/mcp
```

### Codex

```bash
codex mcp add gamemonitoring --url 'https://api.gamemonitoring.net/mcp'
```

### Claude Code

```bash
claude mcp add --scope user --transport http gamemonitoring 'https://api.gamemonitoring.net/mcp'
```

### Gemini CLI

```bash
gemini mcp add --scope user --transport http gamemonitoring 'https://api.gamemonitoring.net/mcp'
```

### MCP JSON

```json
{
  "mcpServers": {
    "gamemonitoring": {
      "url": "https://api.gamemonitoring.net/mcp"
    }
  }
}
```

### 发给智能体的示例提示

```text
通过 GAMEMONITORING 找出在线玩家最多的三台 Rust 服务器，并列出各服务器的地址和在线人数。
```

## MCP 工具

先调用 search_games。将返回的 steam_id 作为 game_steam_id，用于搜索、筛选和统计服务器。查看服务器详情时，使用 search_servers 返回的 GAMEMONITORING 服务器 ID。

### search_games

按名称、网址标识或 Steam App ID 查找游戏，返回 steam_id、名称、网址标识、服务器数和玩家人数。

```json
{
  "name": "Rust",
  "limit": 1
}
```

### get_server_filters

列出地图、版本、国家或地区、语言、游戏模式等筛选项。传入 game_steam_id 可获取指定游戏的筛选项，传入空对象可获取通用筛选项。

```json
{
  "game_steam_id": 252490
}
```

### search_servers

按游戏和其他条件筛选服务器，支持排序、limit（1 到 100）和 offset。指定游戏可缩小搜索范围。

```json
{
  "game_steam_id": 252490,
  "status": "online",
  "sort": "numplayers",
  "limit": 3
}
```

### get_server

根据数字 server_id 返回服务器的公开详情和当前状态。

```json
{
  "server_id": 1
}
```

### get_server_list_metadata

使用与搜索服务器相同的筛选条件，统计匹配的服务器总数、在线服务器数和在线玩家人数。

```json
{
  "game_steam_id": 252490,
  "status": "online"
}
```

## 数据格式

tools/call 调用成功时，result.structuredContent 包含结果数据。result.content 包含结果的文本表示和对应 REST 请求的链接。

协议错误位于顶层 error 字段。工具出错时，即使 HTTP 状态为 200，result.isError 也为 true。服务器提供的错误详情位于 result.structuredContent.error。搜索超时后，可按游戏或其他筛选条件缩小范围。
