remote-mcp-server-with-auth — Claude Code skill
remote-mcp-server-with-auth is a Claude Code skill for building and deploying a Cloudflare Workers MCP server with GitHub OAuth and PostgreSQL. It supports role-based permissions.
no license 168 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill remote-mcp-server-with-auth -a claude-codeWhat remote-mcp-server-with-auth does
This skill guides you through a Cloudflare Workers MCP server where users authenticate through GitHub OAuth and tools can access PostgreSQL. Clients can connect over streamable HTTP at /mcp or the legacy SSE endpoint at /sse. Tool implementations live in separate files under src/tools/; the examples include schema inspection and read-only queries.
A GitHub username allowlist in src/index.ts controls database write access. Query checks restrict the read-only tool, and the database connection is shared across tool calls. Deployment requires GitHub OAuth credentials, a cookie encryption key, DATABASE_URL, and a Cloudflare login through wrangler login. The server cannot authenticate users or connect to the database until those credentials and secrets are configured.
What it helps with
- deploy a remote MCP server on Cloudflare Workers
- add GitHub OAuth sign-in to an MCP server
- limit PostgreSQL write access by GitHub username
- separate database tools into individual files
- offer HTTP and SSE endpoints for MCP clients
Example prompts for the agent
- Create a remote MCP server with GitHub sign-in and PostgreSQL access.
- Set up an MCP server on Cloudflare Workers with HTTP transport and a GitHub username allowlist for writes.
- Add an MCP tool that lists the PostgreSQL schema and describe how to connect to it.
How to install remote-mcp-server-with-auth
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill remote-mcp-server-with-auth -a claude-code2Manually: put the files in place
~/.claude/skills/remote-mcp-server-with-auth/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/remote-mcp-server-with-auth/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill remote-mcp-server-with-auth -a codex2Manually: put the files in place
.agents/skills/remote-mcp-server-with-auth/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill remote-mcp-server-with-auth -a cursor2Manually: put the files in place
.cursor/skills/remote-mcp-server-with-auth/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/remote-mcp-server-with-auth2Manually: put the files in place
.github/skills/remote-mcp-server-with-auth/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill remote-mcp-server-with-auth -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/remote-mcp-server-with-authManually: put the files in place
.devin/skills/remote-mcp-server-with-auth/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill remote-mcp-server-with-auth -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about remote-mcp-server-with-auth
How do I install remote-mcp-server-with-auth in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill remote-mcp-server-with-auth -a claude-code. The skill file is located at ~/.claude/skills/remote-mcp-server-with-auth/SKILL.md.
What does remote-mcp-server-with-auth do?
It guides you in building a remote MCP server for Cloudflare Workers, with GitHub OAuth and PostgreSQL-backed tools. The template supports HTTP and SSE transports.
What do I need to configure for PostgreSQL access?
Set DATABASE_URL, GitHub OAuth credentials, and COOKIE_ENCRYPTION_KEY. Deployment also requires a Cloudflare login using wrangler login.