convez.ai
MCP Server
Astatide1337

Skills-MCP-Gateway

Astatide1337/Skills-MCP-Gateway

Ver no GitHub
InicialPluginScore · de 0 a 100

An MCP server implementing the Agent Skills open standard with Cloudflare Access OAuth

Instalação

$npx convez-ai Astatide1337/Skills-MCP-Gateway

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 dias
Versão
—
Issues abertas
1
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Skills MCP Gateway

An MCP server implementing the Agent Skills open standard. Exposes skill knowledge as MCP resources and discovery tools, with Cloudflare Access OAuth for authentication.

Architecture

┌──────────────┐     ┌─────────────┐     ┌───────────────┐     ┌──────────┐
│ MCP Client   │────▶│ Cloudflare  │────▶│ Skills MCP    │────▶│ ~/skills/│
│ (ChatGPT,    │     │ Access +    │     │ Gateway       │     │ (skills  │
│  Claude)     │◀────│ Tunnel      │◀────│ :8091/mcp     │◀────│  dir)    │
└──────────────┘     └─────────────┘     └───────────────┘     └──────────┘
                                              │
                                         ┌────▼────┐
                                         │ Docker  │
                                         │ Gateway │
                                         │ (internal│
                                         │  mcp)   │
                                         └─────────┘
  • External clients authenticate via Cloudflare Access at the edge, then complete the MCP OAuth flow for a Bearer token
  • Internal Docker gateway connects directly via Docker DNS — auth is bypassed for Docker-internal IPs

Features

  • Skill discovery: skills_list, skills_search, skills_inspect tools
  • Skill reading: skill_read — fetch individual skill files on demand
  • MCP resources: skill://{path} — every skill file registered as a resource
  • OAuth: Full authorization code flow with PKCE, Cloudflare JWT verification, dynamic client registration
  • Containerized: Docker image with uv for fast, reproducible builds

Quick Start

cp .env.example .env
# Edit .env with your Cloudflare Access credentials
docker build -t skills-mcp .
docker run -d \
  -p 127.0.0.1:8091:8091 \
  -v /path/to/skills:/skills \
  --env-file .env \
  skills-mcp

Environment Variables

VariableDescription
PUBLIC_BASE_URLPublic-facing URL (e.g. https://skills.example.com)
MCP_PATHMCP endpoint path (default /mcp)
CLOUDFLARE_TEAM_DOMAINCloudflare Access team domain
CLOUDFLARE_AUDCloudflare Access audience tag
SKILLS_DIRPath to skills directory (default /skills)

Tools

ToolDescription
skills_listList all available skills with full metadata
skills_searchSearch skills by name and description
skills_inspectGet full metadata and file tree for a skill
skill_readRead an individual skill file by path

Skills Directory Structure

~/skills/
├── my-skill/
│   ├── SKILL.md          # Required: YAML frontmatter + markdown
│   ├── instructions.md
│   └── examples/
│       └── example.js
└── another-skill/
    └── SKILL.md

Each skill is a subdirectory with a SKILL.md containing YAML frontmatter (name, description, version, etc.). All files within are accessible via skill_read or the skill:// resource URI.

Ver o original no GitHub

Bom para

Relacionados