gameye-mcp 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +31 -2
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  A [Model Context Protocol](https://modelcontextprotocol.io) server for the [Gameye](https://gameye.com) game server orchestration API. It lets an AI agent (Claude Code, Claude Desktop, Cursor, or any MCP client) launch and inspect game server sessions, check image tags and regions, and fetch logs and artifacts. You talk to it in plain language, and you don't have to leave your editor.
4
4
 
5
- > **Status: beta** (`0.x`). Tools, inputs and outputs may change between releases, and there may be bugs. The server says so to every client that connects, on startup, and in `gameye_context`. It is published on npm as [`gameye-mcp`](https://www.npmjs.com/package/gameye-mcp); see the [changelog](https://github.com/Gameye/gameye-mcp/blob/main/CHANGELOG.md) for what changed in each release.
5
+ > **Status: beta** (`0.x`). Tools, inputs and outputs may change between releases, and there may be bugs. The server says so to every client that connects, on startup, and in `gameye_context`. It is published on npm as [`gameye-mcp`](https://www.npmjs.com/package/gameye-mcp), as a container image at `ghcr.io/gameye/gameye-mcp`, and in the [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.Gameye/gameye-mcp`; see the [changelog](https://github.com/Gameye/gameye-mcp/blob/main/CHANGELOG.md) for what changed in each release.
6
6
 
7
7
  ## Quick start
8
8
 
@@ -64,7 +64,36 @@ Most clients (Claude Desktop, Cursor, Windsurf and others) accept an `mcpServers
64
64
 
65
65
  Restart the client after you change its configuration.
66
66
 
67
- `npx -y gameye-mcp` runs the latest release. To stay on one version, name it: `npx -y gameye-mcp@0.1.0` (or `"args": ["-y", "gameye-mcp@0.1.0"]`).
67
+ `npx -y gameye-mcp` runs the latest release. To stay on one version, name it: `npx -y gameye-mcp@0.1.3` (or `"args": ["-y", "gameye-mcp@0.1.3"]`).
68
+
69
+ ### Docker
70
+
71
+ No Node.js on the machine? Run the published image instead. It works on amd64 and arm64:
72
+
73
+ ```json
74
+ {
75
+ "mcpServers": {
76
+ "gameye": {
77
+ "command": "docker",
78
+ "args": ["run", "-i", "--rm", "-e", "GAMEYE_API_TOKEN", "-e", "GAMEYE_ENV", "ghcr.io/gameye/gameye-mcp"],
79
+ "env": {
80
+ "GAMEYE_API_TOKEN": "<your-token>",
81
+ "GAMEYE_ENV": "sandbox"
82
+ }
83
+ }
84
+ }
85
+ }
86
+ ```
87
+
88
+ With Claude Code: `claude mcp add gameye --env GAMEYE_API_TOKEN=<your-token> -- docker run -i --rm -e GAMEYE_API_TOKEN ghcr.io/gameye/gameye-mcp`.
89
+
90
+ - Pass each variable with `-e NAME` (no value), so Docker copies it from the client's environment and the token never appears in the command line.
91
+ - Keep `-i` and never add `-t`: a terminal mangles the JSON-RPC messages on stdout.
92
+ - To stay on one version, use a version tag such as `ghcr.io/gameye/gameye-mcp:0.1.3`.
93
+ - Files the server writes stay inside the container, and `--rm` deletes them:
94
+ - `gameye_get_artifacts` saves its download under the temp directory. To keep it, mount a directory and point the temp directory at it: `-v /absolute/dir:/out -e TMPDIR=/out`. The path the tool reports is the container path; the file is in `/absolute/dir` on the host.
95
+ - `gameye_create_token` (admin tools only) writes to the `outputPath` you give it. Mount a directory the same way and pass an `outputPath` under `/out`.
96
+ - The server runs as uid 1000, so on Linux the mounted directory must be writable by that user.
68
97
 
69
98
  ## Token scopes
70
99
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "gameye-mcp",
3
- "version": "0.1.1",
4
- "mcpName": "io.github.gameye/gameye-mcp",
3
+ "version": "0.1.3",
4
+ "mcpName": "io.github.Gameye/gameye-mcp",
5
5
  "description": "MCP server for the Gameye game server orchestration API: launch and inspect sessions, check image tags, fetch logs and artifacts from any MCP client",
6
6
  "main": "dist/index.js",
7
7
  "bin": {