Authplane TypeScript SDK MCP server

Commit 9. Nov. 2026

authplane/ts-sdk · typescript · Apache-2.0

Bietet OAuth 2.1 und JWT-Validierungs-Primitives zum Schutz von MCP server und resource server mittels Authplane Authorization Tokens.

Auch bekannt als AuthPlane/ts-sdk

Security Developer Tools

GitHub ↗

Stars: 7
Tools: —
Downloads, 30 Tage: —
Neueste Version: —
Letzter Commit: 9. Nov. 2026
Lizenz: Apache-2.0

Was ist Authplane TypeScript SDK MCP?

Authplane TypeScript SDK ist ein MCP server. Bietet OAuth 2.1 und JWT-Validierungs-Primitives zum Schutz von MCP server und resource server mittels Authplane Authorization Tokens.

Zusammenfassung generiert aus dem README des Projekts

Über Authplane TypeScript SDK MCP server

Die Hauptfunktion dieses TypeScript SDKs ist der Schutz von MCP server und resource server mit Authplane Authorization Tokens. Es bietet Entwicklern OAuth 2.1 und JWT-Validierungs-Primitives, die speziell für Node.js-Umgebungen entwickelt wurden. Das Toolkit enthält spezialisierte Adapter für das offizielle MCP TypeScript SDK, FastMCP, Hono und NestJS, was eine einfache Integration in bestehende Web-Frameworks und Server-Architekturen ermöglicht.

Entwickler nutzen diese Pakete, um strikte Sicherheitsmaßnahmen wie asymmetrische Signierung, DPoP-Proof-Verifizierung und Token-Introspection zur Revocation zu implementieren. Das SDK erfordert Node.js 22 LTS oder neuer und unterstützt spezifische Module-Resolution-Einstellungen für TypeScript-Nutzer. Es übernimmt komplexe Sicherheitsaufgaben wie SSRF-Hardening, Claim-Validierung und Circuit Breaking bei Interaktionen mit dem Authorization Server, um zuverlässige und sichere Authentifizierungsprozesse zu gewährleisten.

Was du damit machen kannst

1FastMCP server absichernEin Entwickler kann die Authentifizierung für einen FastMCP server hinzufügen, indem er die authplaneFastMcpAuth Funktion mit spezifischen Issuer- und Scope-Anforderungen nutzt.
2DPoP für erhöhte Sicherheit implementierenDas SDK ermöglicht die Inbound-Proof-Verifizierung sowie die Outbound-Proof-Generierung zur Unterstützung von DPoP-Standards.

Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.

Automatisierte Checks

Geluften am 15. Nov. 2026Vollständiger Bericht →

58/100

Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst

Diesen Score in deinem README anzeigen

Source Repository verknüpft und erreichbarauthplane/ts-sdk is public and reachablegithub.com/authplane/ts-sdk ↗Bestanden
Paket nennt dieses Repository als QuelleNicht geprüft
Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
Commit oder Release im letzten JahrLast commit or release 2026-11-09github.com/authplane/ts-sdk ↗Bestanden
OpenSSF ScorecardNicht geprüft
Package-Name ähnelt keinem populären PackageNicht geprüft
Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
Destruktive Tools sind markiertNicht geprüft
Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft

README

Auf GitHub ansehen

Authplane 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: moduleResolution set to bundler, node16, or nodenext (required for the package exports subpaths)

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-Authenticate responses).
RFC 7234 — HTTP caching semantics on discovery responses (AS metadata + JWKS).
RFC 7519 / 7517 — JWT and JWKS.
RFC 7638 — JWK thumbprints (jkt for DPoP binding).

Security

Asymmetric-only signing (ES256, RS256 by default; extend allowedAlgorithms to accept others); none and HMAC algorithms rejected at construction time.
Strict claim validation: exact iss match, aud membership, 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/ath checks, cnf.jkt binding enforcement, optional caller-supplied replay store for JTI uniqueness.
DPoP (outbound): proof generation with use_dpop_nonce retry 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 6750 WWW-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 http through 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.

Vollständiges README lesen

Authplane TypeScript SDK MCP Fragen

Welche Frameworks werden vom SDK unterstützt?

Das SDK enthält Adapter für Hono, NestJS, FastMCP und das offizielle MCP TypeScript SDK.

Welche Node.js-Anforderungen gibt es für die Nutzung dieses SDKs?

Du benötigst Node.js 22 LTS oder eine neuere Version.

Fakten

15. Nov. 2026

Stars: 7
Downloads, 30 Tage: —
Neueste Version: —
Letzter Commit: 9. Nov. 2026
Lizenz: Apache-2.0
Transport: —
Paket: —

AuthPlane ↗

Community Publisher

Veröffentlicht von einem unabhängigen Maintainer.

Mehr von AuthPlane →

Repository verlinkt
Open-Source-Lizenz
Aktiv in den letzten 365 Tagen

Alternativen

Funktioniert mit

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge für dein README

Zeige deinen HostedMCP-Checks-Score. Das Badge führt Leser zu Installationsanleitungen für jeden Client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/authplane/ts-sdk.svg)](https://hostedmcp.org/servers/authplane/ts-sdk/checks)

Maintainer?

Übernimm diesen Eintrag, um ihn zu bearbeiten und das HostedMCP-Badge zu deinem README hinzuzufügen.

Eintrag übernehmen

Vor der Installation

Server laufen mit den Berechtigungen, die du ihnen gibst. Nutze den am engsten gefassten Token oder die Datenbank-Role, die für die Aufgabe nötig ist.

Über Authplane TypeScript SDK MCP server

Was du damit machen kannst

1FastMCP server absichernEin Entwickler kann die Authentifizierung für einen FastMCP server hinzufügen, indem er die authplaneFastMcpAuth Funktion mit spezifischen Issuer- und Scope-Anforderungen nutzt.
2DPoP für erhöhte Sicherheit implementierenDas SDK ermöglicht die Inbound-Proof-Verifizierung sowie die Outbound-Proof-Generierung zur Unterstützung von DPoP-Standards.

Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.

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

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, });