@modemdev/glance-codex
v0.1.1
Published
glance.sh MCP server package for Codex
Readme
glance.sh plugin for Codex
Codex CLI integration that adds glance.sh screenshot tools via MCP.
What it does
Adds two MCP tools:
glance— creates/reuses a live session and returns a URL likehttps://glance.sh/s/<id>glance_wait— waits for the next pasted image and returnsScreenshot: https://glance.sh/<token>.<ext>
The server keeps a background SSE listener alive, reconnects automatically, and refreshes sessions before they expire.
Install
Recommended (npm package):
codex mcp add glance -- npx -y @modemdev/glance-codexOptional: pin a specific version:
codex mcp add glance -- npx -y @modemdev/[email protected]Local development / manual install:
codex mcp add glance -- node /absolute/path/to/glance-agent-plugins/codex/servers/glance-mcp.jsVerify
- Confirm the MCP server is configured:
codex mcp list
codex mcp get glance --json- Ask Codex to call
glance. - Open the returned
https://glance.sh/s/<id>URL and paste an image. - Ask Codex to call
glance_wait. - Confirm Codex receives
Screenshot: <url>.
Update / remove
Update:
codex mcp remove glance
codex mcp add glance -- npx -y @modemdev/glance-codexRemove:
codex mcp remove glancePublishing (maintainers)
Releases are automated via GitHub Actions.
Prerequisite: configure NPM_TOKEN in the glance-agent-plugins repository with publish access to @modemdev/glance-codex.
- Bump
versionincodex/package.json. - Commit and push to
main. - Create and push a matching tag:
git tag codex-v0.1.1
git push origin codex-v0.1.1The Release codex package workflow validates tag/version alignment, checks for already-published versions, runs npm pack --dry-run, and publishes with npm provenance.
How it works
Codex calls glance
└─▶ MCP server POST /api/session
└─▶ returns session URL
Codex calls glance_wait
└─▶ waits for SSE image event
User pastes image at /s/<id>
└─▶ glance.sh emits image event
└─▶ tool returns Screenshot: <url>Requirements
- Codex CLI with MCP support
- Node.js runtime available to launch the stdio MCP server
Configuration
Optional environment variable:
GLANCE_BASE_URL(default:https://glance.sh)
