MCP server de Authplane TypeScript SDK
Commit 9 nov 2026Proporciona primitivas de validación de JWT y OAuth 2.1 para proteger MCP servers y resource servers utilizando tokens de autorización de Authplane.
También conocido como AuthPlane/ts-sdk
- Stars
- 7
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 9 nov 2026
- Licencia
- Apache-2.0
¿Qué es Authplane TypeScript SDK MCP?
Authplane TypeScript SDK es un MCP server. Proporciona primitivas de validación de JWT y OAuth 2.1 para proteger MCP servers y resource servers utilizando tokens de autorización de Authplane.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Authplane TypeScript SDK
La función principal de este SDK de TypeScript es proteger MCP servers y resource servers con tokens de autorización de Authplane. Ofrece a los desarrolladores primitivas de validación de JWT y OAuth 2.1 diseñadas para entornos Node.js. El kit de herramientas incluye adaptadores especializados para el SDK oficial de MCP para TypeScript, FastMCP, Hono y NestJS, lo que permite una integración sencilla en arquitecturas de servidor y frameworks web existentes.
Los desarrolladores utilizan estos paquetes para implementar medidas de seguridad estrictas, como el firmado únicamente asimétrico, la verificación de pruebas DPoP y la introspección de tokens para revocación. El SDK requiere Node.js 22 LTS o superior y admite configuraciones de resolución de módulos específicas para usuarios de TypeScript. Gestiona tareas de seguridad complejas como el endurecimiento contra SSRF, la validación de claims y el circuit breaking durante las interacciones con el servidor de autorización para garantizar procesos de autenticación fiables y seguros.
Qué puedes hacer con él
- 1Asegurar servidores FastMCPUn desarrollador puede añadir autenticación a un servidor FastMCP utilizando la función authplaneFastMcpAuth con requisitos específicos de issuer y scope.
- 2Implementar DPoP para mayor seguridadEl SDK permite la verificación de pruebas entrantes y la generación de pruebas salientes para dar soporte a los estándares DPoP.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleauthplane/ts-sdk is public and reachablegithub.com/authplane/ts-sdk ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-09github.com/authplane/ts-sdk ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubAuthplane TypeScript SDK
OAuth, JWT validation, and MCP-authentication primitives for Node.js. Ships framework adapters for Hono, NestJS, FastMCP, and the official MCP TypeScript SDK.
Packages
| Package | Install | Purpose |
|---|---|---|
@authplane/sdk |
npm install @authplane/sdk |
JWT validation and OAuth protocol primitives. Ships the stateful AuthplaneClient (@authplane/sdk/core) plus stateless OAuth protocol helpers (@authplane/sdk/auth). |
@authplane/mcp |
npm install @authplane/sdk @authplane/mcp |
JWT validation adapter for the MCP TypeScript SDK |
@authplane/fastmcp |
npm install @authplane/sdk @authplane/fastmcp |
JWT validation adapter for FastMCP |
@authplane/hono |
npm install @authplane/sdk @authplane/hono |
JWT validation middleware for the Hono web framework |
@authplane/nestjs |
npm install @authplane/sdk @authplane/nestjs |
NestJS module: guard + decorators + exception filter + PRM controller |
Requirements
- Node.js 22 LTS (or newer)
- TypeScript consumers:
moduleResolutionset tobundler,node16, ornodenext(required for the packageexportssubpaths)
Compatibility
- Tested against authserver 0.2.0.
- Introspection-based revocation (
IntrospectionRevocation) requires authserver 0.1.2 or newer, and a resource-server client that is confidential and either the issuing client or a runtime-client of the Resource.
Quickstart
import { FastMCP } from "fastmcp";
import { authplaneFastMcpAuth } from "@authplane/fastmcp";
const auth = await authplaneFastMcpAuth({
issuer: "http://localhost:9000",
resource: "http://localhost:8090/mcp",
scopes: ["tools/weather"],
});
const server = new FastMCP({
name: "my-server",
version: "1.0.0",
authenticate: auth.authenticate,
});
For the MCP TypeScript SDK variant, see the @authplane/mcp README.
Capabilities
Standards and RFCs
- OAuth 2.1 (draft-ietf-oauth-v2-1) — profile-aligned token validation defaults.
- RFC 8414 — Authorization Server Metadata discovery.
- RFC 9068 — JWT Profile for OAuth 2.0 Access Tokens (
typ: at+jwt, required claims). - RFC 7662 — Token Introspection (can be wired as a revocation checker via
IntrospectionRevocation). - RFC 7009 — Token Revocation.
- RFC 8693 — Token Exchange.
- RFC 9728 — OAuth Protected Resource Metadata (JSON builder and well-known URL).
- RFC 9449 — DPoP, covering outbound proof generation (
DPoPProvider) and inbound proof verification with replay-store hook. - RFC 8707 — Resource Indicators (honored by client credentials and token exchange).
- RFC 6750 — Bearer Token Usage (adapters emit RFC-compliant
WWW-Authenticateresponses). - RFC 7234 — HTTP caching semantics on discovery responses (AS metadata + JWKS).
- RFC 7519 / 7517 — JWT and JWKS.
- RFC 7638 — JWK thumbprints (
jktfor DPoP binding).
Security
- Asymmetric-only signing (ES256, RS256 by default; extend
allowedAlgorithmsto accept others);noneand HMAC algorithms rejected at construction time. - Strict claim validation: exact
issmatch,audmembership,typ: at+jwt, required claims (sub,client_id,exp,iat,jti), configurable clock skew (30s default). - SSRF hardening on every outbound fetch: HTTPS-only by default, blocks loopback, private networks, cloud metadata (169.254.0.0/16), multicast, reserved ranges. Dev-mode toggle relaxes these for local development only.
- Response size caps on metadata and JWKS fetches.
- DPoP (inbound):
htm/htu/athchecks,cnf.jktbinding enforcement, optional caller-supplied replay store for JTI uniqueness. - DPoP (outbound): proof generation with
use_dpop_nonceretry support. - Circuit breaker around AS interactions (default threshold 5 failures, cooldown 30s).
- Token caching for client-credentials responses with TTL buffer (default 30s before expiry).
Framework integrations
@authplane/mcp— adapter for the official MCP TypeScript SDK.@authplane/fastmcp— adapter for FastMCP.@authplane/hono— middleware for the Hono web framework (Bearer / DPoP, RFC 6750WWW-Authenticate, PRM handler, scope enforcement).@authplane/nestjs— NestJS module:AuthplaneAuthGuard,@SkipAuth()/@RequireScopes(...)decorators, exception filter mapping to RFC 6750 §3 responses, and an RFC 9728 PRM controller. Works on Express and Fastify platform adapters.- The MCP / FastMCP adapters integrate with Express / Node.js
httpthrough their respective transports; the Hono adapter is framework-native middleware; the NestJS adapter integrates with whatever platform NestJS is hosted on.
Documentation
Each package ships its own README (overview) and User Guide (complete reference):
@authplane/sdk— README · User Guide@authplane/mcp— README · User Guide@authplane/fastmcp— README · User Guide@authplane/hono— README · User Guide@authplane/nestjs— README · User Guide
Other docs:
- CHANGELOG.md — release history
- SECURITY.md — vulnerability reporting
- CONTRIBUTING.md — for external contributors
- RELEASE_POLICY.md — versioning and release flow
License
Apache 2.0 — see LICENSE.
Preguntas sobre Authplane TypeScript SDK MCP
¿Qué frameworks son compatibles con el SDK?
El SDK incluye adaptadores para Hono, NestJS, FastMCP y el SDK oficial de MCP para TypeScript.
¿Cuáles son los requisitos de Node.js para usar este SDK?
Necesitas Node.js 22 LTS o una versión más reciente.