convez.ai
MCP Server
brewek

mcp-server-ggdeals

brewek/mcp-server-ggdeals

Ver no GitHub
InicialPluginScore · de 0 a 100

A Model Context Protocol (MCP) server for integrating with gg.deals

Instalação

$npx convez-ai brewek/mcp-server-ggdeals

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v1.0.8
Issues abertas
12
Contribuidores
3

README

A tradução para o português deste README ainda está na fila.

mcp-server-ggdeals

CI

A Model Context Protocol (MCP) server for integrating with gg.deals. Designed for Large Language Models to fetch game prices, historical lows, and bundles.

Installation & Usage

Use npx to run the server instantly in your MCP Client (e.g., Claude Desktop). No cloning required.

claude_desktop_config.json:

{
  "mcpServers": {
    "ggdeals": {
      "command": "npx",
      "args": ["-y", "mcp-server-ggdeals"],
      "env": {
        "GG_DEALS_API_KEY": "your_api_key_here"
      }
    }
  }
}

You can generate your API key at https://gg.deals/settings/ -> Connections -> GG.deals API key.

Available Tools

`

  • search_games: Find a base game ID by title. (Note: This tool queries Steam Store API to retrieve Steam App ID, which is used for all gg.deals api calls).
  • get_game_prices: Fetch current prices (Official & Keyshops).
  • get_historical_low: Fetch the all-time lowest price.
  • get_game_bundles: Fetch Premium/Deluxe DLC bundles linked to a base game.

Architecture

Minimalist and modular codebase built with TypeScript and Zod:

  • src/index.ts: MCP routing & initialization
  • src/api.ts: Shared Axios client & error handling
  • src/search.ts: Search logic
  • src/prices.ts: Pricing & historical data
  • src/bundles.ts: Bundles discovery

Development

npm install
npm run build
npm run dev
Ver o original no GitHub

Relacionados