Metadata-Version: 2.4
Name: igdb-mcp-client
Version: 0.1.0
Summary: STDIO-to-StreamableHTTP bridge for the IGDB MCP Server
Requires-Python: >=3.10
Requires-Dist: httpx
Requires-Dist: httpx-sse
Requires-Dist: mcp
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: hypothesis>=6.100; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# igdb-mcp-client

A Python bridge that connects any [MCP](https://modelcontextprotocol.io/) client to the [IGDB MCP Server](https://api-docs.igdb.com/#mcp-server), giving your AI agent access to game data from the IGDB database.

Handles OAuth 2.0 authentication automatically.

## Install

```bash
uvx igdb-mcp-client
```

Or with pip:

```bash
pip install igdb-mcp-client
```

## Quick Start

Set your credentials and run:

```bash
export CLIENT_ID="your-client-id"
export CLIENT_SECRET="your-client-secret"
igdb-mcp-client
```

The client connects to `https://mcp.igdb.com` by default, reads JSON-RPC from stdin, and writes responses to stdout.

## Use with your MCP client

Most MCP clients use a JSON config file to register servers. Add `igdb-mcp-client` as a stdio transport:

```json
{
  "mcpServers": {
    "igdb": {
      "command": "uvx",
      "args": ["igdb-mcp-client"],
      "env": {
        "CLIENT_ID": "your-client-id",
        "CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}
```

This works with Claude Desktop, Cursor, Kiro, Windsurf, and any MCP-compatible client that supports stdio transports.

Once connected, your agent can query the IGDB game database — search games, browse genres, platforms, companies, and more.

## Configuration

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `CLIENT_ID` | *(required)* | OAuth 2.0 client ID |
| `CLIENT_SECRET` | *(required)* | OAuth 2.0 client secret |
| `MCP_SERVER_URL` | `https://mcp.igdb.com` | Server URL (overridable via CLI arg too) |
| `AUTH_DOMAIN` | `https://mcp-auth.igdb.com` | Auth endpoint base URL |
| `LOG_LEVEL` | `INFO` | Set to `DEBUG` for HTTP request/response logs |

You can also pass the server URL as a CLI argument, which takes highest priority:

```bash
igdb-mcp-client https://mcp.igdb.com
```


## Requirements

Python 3.10+

## License

MIT
