Metadata-Version: 2.4
Name: mcp-epic-free-games
Version: 0.1.1
Summary: A Model Context Protocol server for Epic Games Store free games information
Project-URL: Homepage, https://github.com/meethuhu/mcp-epic-free-games
Project-URL: Repository, https://github.com/meethuhu/mcp-epic-free-games
Project-URL: Issues, https://github.com/meethuhu/mcp-epic-free-games/issues
Author-email: meethuhu <meethuhu@example.com>
License: MIT
License-File: LICENSE
Keywords: epic games,free games,mcp,model context protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.9.4
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# MCP Epic Free Games

A Model Context Protocol (MCP) server that provides access to Epic Games Store free games information.

## Installation

```bash
pip install mcp-epic-free-games
```

## Usage

Add the following to your MCP client configuration:

```json
{
  "mcpServers": {
    "epic-free-games": {
      "type": "stdio",
      "description": "Get free game information from Epic Games Store.",
      "command": "mcp-epic-free-games",
      "env": {
        "TIME_ZONE": "Asia/Shanghai"
      }
    }
  }
}
```

## Features

This server provides tools to get information about free games on the Epic Games Store.

### `get_now_free_games`

Get information about currently free games.

**Returns:** Game title, description, cover image, claim URL, and free period dates.

### `get_upcoming_free_games`

Get information about upcoming free games.

**Returns:** Game title, description, cover image, claim URL, and free period dates.

## License

MIT License

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.