Helldivers2 Mcp

io.github.xerno42由 GitHub 账号 xerno42 发布v1.0.2更新于 Oct 24, 2026

MCP server exposing live Helldivers 2 galactic war data.

已验证Streamable HTTP可网页运行

服务详情

标识符: io.github.xerno42/helldivers2-mcp
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 xerno42。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.xerno42%2Fhelldivers2-mcp.svg)](https://sourceweft.com/mcp/io.github.xerno42%2Fhelldivers2-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

只读的 MCP 服务器，让助手获取《绝地潜兵 2》银河战争的实时数据：战况统计、主要指令、星球、快讯、Steam 新闻与民主太空站。

可以做什么: 读取全局战况统计与活跃星球，包括各阵营击杀数、任务胜负、命中率与影响倍率
读取当前主要指令，含简报、解析后的任务列表、进度、奖励与剩余时间
列出全部星球，并一次获取最多五个星球的详细信息：生态、危险、归属、生命值、事件与区域
读取游戏内快讯与 Steam 新闻，可限制返回条数
读取民主太空站详情：所在星球、下次投票剩余时间与当前战术行动
适用场景: 适合让助手回答《绝地潜兵 2》银河战争当前局势、总结主要指令或新闻、比较星球并规划作战地点，无需打开游戏。
运行要求: 可使用托管端点，或本地运行：npm 包与容器镜像需要 Node.js 22+ 或 Docker。自托管需设置环境变量 X_SUPER_CONTACT 填入联系邮箱，该值会转发给上游社区 API。另有端口、绑定地址、允许的浏览器来源与限流等可选配置。

安装前请注意

自托管时必须提供真实联系邮箱（X_SUPER_CONTACT），该值会转发给第三方社区 API api.helldivers2.dev。所有工具仅读取数据，不会写入或修改任何内容。托管实例为第三方公共服务，请求与查询会发送到该服务。

安装

在 SourceWeft 中

打开控制台中的 Helldivers2 Mcp，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.xerno42%2Fhelldivers2-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "helldivers2": {
      "type": "http",
      "url": "https://mcp.avengersofsuperearth.com/mcp"
    }
  }
}

README

helldivers2-mcp

[npm version] [CI] [Docker Hub] [License: MIT]

A stateless Model Context Protocol (MCP) server that exposes live Helldivers 2 galactic war data to LLMs.

Data is sourced from the community API at api.helldivers2.dev.

Packages

Tools

Tool	Description
`get_war_status`	Galaxy-wide war statistics (kills by faction, missions won/lost, accuracy, deaths, impact multiplier) and active planets with owner, player count, active events, attack vectors, and region health
`get_assignments`	Active Major Orders with title, briefing, decoded task list (faction, difficulty, target planet), current progress numbers, reward type and amount, and time until expiry
`get_all_planets`	Full planet list with IDs, names, and sectors
`get_planet_details`	Detailed per-planet info: biome, hazards, initial/current owner, health, waypoints, active events, full combat statistics, attacking planets, and regions (up to 5 planets per call)
`get_dispatches`	In-game dispatch feed — High Command broadcasts with published date (relative time) and message text; optional `limit` parameter (default 20, max 50)
`get_steam_news`	Steam news for Helldivers 2 with title, URL, publish date (relative time), and full article content; optional `limit` parameter (default 10, max 30)
`get_space_station_details`	DSS details: current host planet (full planet info), time until next election, and active tactical actions with name, description, status, planet effects, and resource costs

Quickstart

Prerequisites

Node.js 22+ or Docker
A contact email for the X-Super-Contact header (required by the upstream API)

Local dev

bash

cp .env.example .env   # set [email protected]npm installnpm run dev               # hot-reload via tsx watch on :3000

cp .env.example .env   # set [email protected]npm installnpm run dev               # hot-reload via tsx watch on :3000

Production build

Docker

Image is available on Docker Hub and GitHub Container Registry.

bash

docker pull xerno42/helldivers2-mcp        # pull from Docker Hub# ordocker pull ghcr.io/xerno42/helldivers2-mcp # pull from GHCR# ordocker build -t helldivers2-mcp . # build locally
#then run with:docker run -p 3000:3000 -e [email protected] helldivers2-mcp

docker pull xerno42/helldivers2-mcp        # pull from Docker Hub# ordocker pull ghcr.io/xerno42/helldivers2-mcp # pull from GHCR# ordocker build -t helldivers2-mcp . # build locally
#then run with:docker run -p 3000:3000 -e [email protected] helldivers2-mcp

Configuration

All configuration is via environment variables.

Variable	Default	Description
`X_SUPER_CONTACT`	(required)	Forwarded as `X-Super-Contact` to the upstream API per their usage guidelines
`PORT`	`3000`	HTTP port to listen on
`BIND_HOST`	`127.0.0.1`	Interface to bind (`0.0.0.0` for Docker/containers)
`MCP_ALLOWED_ORIGINS`	(unset)	Comma-separated list of allowed browser `Origin` headers. Unset means browser-originated requests are blocked; server-to-server calls (no `Origin` header) are always allowed
`MCP_RATE_LIMIT_PER_MIN`	`60`	Sustained request rate limit (requests per minute)
`MCP_RATE_LIMIT_BURST`	`= MCP_RATE_LIMIT_PER_MIN`	Burst capacity for the token-bucket rate limiter

Endpoints

The server uses the stateless Streamable HTTP transport. Each POST /mcp request creates a fresh McpServer + transport pair, handles the request, then tears them down. There is no session state.

Usage in Code

Call the MCP server directly over HTTP using the Streamable HTTP transport. Each request is a JSON-RPC tools/call message sent to POST /mcp.

JavaScript / TypeScript

Using the official MCP TypeScript SDK:

typescript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-app", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(  new URL("https://mcp.avengersofsuperearth.com/mcp"));
await client.connect(transport);
// List available toolsconst { tools } = await client.listTools();console.log(tools.map((t) => t.name));
// Get current war statusconst warStatus = await client.callTool({  name: "get_war_status",  arguments: {},});console.log(warStatus.content[0].text);
// Get details for specific planets by index (up to 5)const planets = await client.callTool({  name: "get_planet_details",  arguments: { planetindices: [57, 153] },});console.log(planets.content[0].text);
await client.close();

import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-app", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(  new URL("https://mcp.avengersofsuperearth.com/mcp"));
await client.connect(transport);
// List available toolsconst { tools } = await client.listTools();console.log(tools.map((t) => t.name));
// Get current war statusconst warStatus = await client.callTool({  name: "get_war_status",  arguments: {},});console.log(warStatus.content[0].text);
// Get details for specific planets by index (up to 5)const planets = await client.callTool({  name: "get_planet_details",  arguments: { planetindices: [57, 153] },});console.log(planets.content[0].text);
await client.close();

Without the SDK — raw JSON-RPC over fetch:

typescript

async function callTool(name: string, args: Record<string, unknown> = {}) {  const res = await fetch("https://mcp.avengersofsuperearth.com/mcp", {    method: "POST",    headers: {      "Content-Type": "application/json",      "Accept": "application/json, text/event-stream",    },    body: JSON.stringify({      jsonrpc: "2.0",      id: 1,      method: "tools/call",      params: { name, arguments: args },    }),  });  const text = await res.text();  // The response is an SSE frame ("event: message\ndata: {json}\n\n");  // concatenate its data line(s) to recover the JSON-RPC payload.  const json = text    .split("\n")    .filter((line) => line.startsWith("data:"))    .map((line) => line.slice(5).trim())    .join("");  const data = JSON.parse(json);  return data.result.content[0].text;}
const status = await callTool("get_war_status");const assignments = await callTool("get_assignments");const dispatches = await callTool("get_dispatches", { limit: 5 });const planets = await callTool("get_planet_details", { planetindices: [57, 153] });

async function callTool(name: string, args: Record<string, unknown> = {}) {  const res = await fetch("https://mcp.avengersofsuperearth.com/mcp", {    method: "POST",    headers: {      "Content-Type": "application/json",      "Accept": "application/json, text/event-stream",    },    body: JSON.stringify({      jsonrpc: "2.0",      id: 1,      method: "tools/call",      params: { name, arguments: args },    }),  });  const text = await res.text();  // The response is an SSE frame ("event: message\ndata: {json}\n\n");  // concatenate its data line(s) to recover the JSON-RPC payload.  const json = text    .split("\n")    .filter((line) => line.startsWith("data:"))    .map((line) => line.slice(5).trim())    .join("");  const data = JSON.parse(json);  return data.result.content[0].text;}
const status = await callTool("get_war_status");const assignments = await callTool("get_assignments");const dispatches = await callTool("get_dispatches", { limit: 5 });const planets = await callTool("get_planet_details", { planetindices: [57, 153] });

Python

Using the official MCP Python SDK:

python

import asynciofrom mcp import ClientSessionfrom mcp.client.streamable_http import streamablehttp_client
async def main():    async with streamablehttp_client("https://mcp.avengersofsuperearth.com/mcp") as (read, write, _):        async with ClientSession(read, write) as session:            await session.initialize()
            # List available tools            tools = await session.list_tools()            print([t.name for t in tools.tools])
            # Get current war status            result = await session.call_tool("get_war_status", {})            print(result.content[0].text)
            # Get details for specific planets by index (up to 5)            result = await session.call_tool(                "get_planet_details",                {"planetindices": [57, 153]},            )            print(result.content[0].text)
asyncio.run(main())

import asynciofrom mcp import ClientSessionfrom mcp.client.streamable_http import streamablehttp_client
async def main():    async with streamablehttp_client("https://mcp.avengersofsuperearth.com/mcp") as (read, write, _):        async with ClientSession(read, write) as session:            await session.initialize()
            # List available tools            tools = await session.list_tools()            print([t.name for t in tools.tools])
            # Get current war status            result = await session.call_tool("get_war_status", {})            print(result.content[0].text)
            # Get details for specific planets by index (up to 5)            result = await session.call_tool(                "get_planet_details",                {"planetindices": [57, 153]},            )            print(result.content[0].text)
asyncio.run(main())

Without the SDK — raw JSON-RPC over httpx:

python

import httpx
MCP_URL = "https://mcp.avengersofsuperearth.com/mcp"
def call_tool(name: str, arguments: dict = {}) -> str:    payload = {        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {"name": name, "arguments": arguments},    }    headers = {        "Content-Type": "application/json",        "Accept": "application/json, text/event-stream",    }    response = httpx.post(MCP_URL, json=payload, headers=headers)    response.raise_for_status()    import json    # The response is an SSE frame ("event: message\ndata: {json}\n\n");    # concatenate its data line(s) to recover the JSON-RPC payload.    text = "".join(        line[5:].strip()        for line in response.text.splitlines()        if line.startswith("data:")    )    return json.loads(text)["result"]["content"][0]["text"]
status = call_tool("get_war_status")assignments = call_tool("get_assignments")planets = call_tool("get_planet_details", {"planetindices": [57, 153]})

import httpx
MCP_URL = "https://mcp.avengersofsuperearth.com/mcp"
def call_tool(name: str, arguments: dict = {}) -> str:    payload = {        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {"name": name, "arguments": arguments},    }    headers = {        "Content-Type": "application/json",        "Accept": "application/json, text/event-stream",    }    response = httpx.post(MCP_URL, json=payload, headers=headers)    response.raise_for_status()    import json    # The response is an SSE frame ("event: message\ndata: {json}\n\n");    # concatenate its data line(s) to recover the JSON-RPC payload.    text = "".join(        line[5:].strip()        for line in response.text.splitlines()        if line.startswith("data:")    )    return json.loads(text)["result"]["content"][0]["text"]
status = call_tool("get_war_status")assignments = call_tool("get_assignments")planets = call_tool("get_planet_details", {"planetindices": [57, 153]})

Connecting to Claude Desktop

Hosted server (easiest)

A public instance is available at https://mcp.avengersofsuperearth.com/mcp. No setup required — just add it to your claude_desktop_config.json:

json

{  "mcpServers": {    "helldivers2": {      "url": "https://mcp.avengersofsuperearth.com/mcp"    }  }}

{  "mcpServers": {    "helldivers2": {      "url": "https://mcp.avengersofsuperearth.com/mcp"    }  }}

Self-hosted (local binary)

json

{  "mcpServers": {    "helldivers2": {      "command": "node",      "args": ["/path/to/helldivers2-mcp/dist/index.js"],      "env": {        "X_SUPER_CONTACT": "[email protected]"      }    }  }}

{  "mcpServers": {    "helldivers2": {      "command": "node",      "args": ["/path/to/helldivers2-mcp/dist/index.js"],      "env": {        "X_SUPER_CONTACT": "[email protected]"      }    }  }}

Self-hosted (HTTP server)

Development

bash

npm run test              # Jest (ESM mode)npm run test:watchnpm run test:coveragenpm run lint              # ESLint

npm run test              # Jest (ESM mode)npm run test:watchnpm run test:coveragenpm run lint              # ESLint

Run a single test file:

Adding a tool

Create src/tools/your-tool.ts and export a Tool object with .definition and .handler.
Import it and add it to the TOOLS array in src/index.ts.
Return textResponse(...) on success or errorResponse(...) on failure — never throw from a handler.
All upstream calls must go through hd2Fetch (in-memory 2-minute cache + rate-limit-aware queue).

License

MIT

来源：README.md，提交 e7c9201

工具

get_war_status

Get War Status

Fetch the current war status and active planets. Returns aggregated war statistics (impact multiplier, total missions won, total missions lost, total mission time, total terminid kills, total automaton kills, total illuminate kills, total bullets fired, total bullets hit, total deaths, total revives, total friendly fire casualties, overall mission success rate, overall accuracy), and a list of active planets (planets with active players or ownership change) with their name, sector, initial owner, current owner, player count, active event information if any (Event: faction, current health, max health, start and end time), the planets each active planet is currently attacking (id and name), and active regions (Region: name, health, max health, regen per second, size, active players).

无需输入参数。

get_assignments

Get Assignments

Fetch the currently active assignments (Major Orders) issued by Super Earth high command. Returns each assignment with title, briefing, task description, decoded task list (type and value information including races, difficulties, and target planet names), current progress numbers, reward (type and amount), and expiration (seconds until expiry).

无需输入参数。

get_all_planets

Get All Planets

Fetch a list of all planets in the current galactic war. Returns a list of planets with their id (index), name, and sector.

无需输入参数。

get_planet_details

Get Planet Details

Fetch detailed information about one or more planets by providing their planet index/indices. Requires: planetindices parameter (array of integers of planet indices, maximum of 5) Returns: For each planet - index, name, sector, biome (Biome: name, description), hazards (Hazard: name, description), position, list of waypoints (planet indices) the planet is connected to, max health, current health, initial owner, current owner, regen per second, event information if one is active (faction who initiated the event, current health, max health, start and end time), statistics (Statistics: missions won, missions lost, mission time, terminid kills, automaton kills, illuminate kills, bullets fired, bullets hit, time played, deaths, revives, friendly fire casualties, mission success rate, accuracy, player count), attacking (a list of planet indices this planet is currently attacking), regions (Region: name, description, health, max health, size, regen per second, active players).

输入参数planetindices必填

get_dispatches

Get Dispatches

Fetch the latest dispatches (news feed) from Super Earth high command. Returns recent dispatches with their published date (relative time) and message text. Optional `limit` parameter caps how many items to return (default 20, max 50).

输入参数limit

get_steam_news

Get Steam News

Fetch the latest Steam news for Helldivers 2. Returns recent items with title, URL, published date (relative time), and content. Optional `limit` parameter caps how many items to return (default 10, max 30).

输入参数limit

get_space_station_details

Get Space Station Details

Fetch the current Democracy Space Station (DSS) details. Returns the planet the DSS is currently supporting (full planet details), election end (relative time until the next planet vote ends), and a list of active tactical actions (Tactical action: name, description, strategic description, status, status expire, effects (Effect: name, description), costs (Cost: item name, current value, delta per second, max donation amount)).

无需输入参数。

版本历史

v1.0.2最新Sep 26, 2026
v1.0.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

近 30 天内可连通必需25 分
已声明认证方式必需10 分
已列出工具必需15 分
描述必需15 分
图标10 分
文档15 分
许可证10 分

Method	Path	Description
`POST`	`/mcp`	MCP Streamable HTTP transport endpoint
`GET`	`/health`	Liveness check — returns `{ "ok": true }`

Registry	Package
npm	`helldivers2-mcp`
Docker Hub	`xerno42/helldivers2-mcp`
GitHub Container Registry	`ghcr.io/xerno42/helldivers2-mcp`
MCP Registry	`io.github.xerno42/helldivers2-mcp`