Authplane TypeScript SDK MCP sunucusu

Commit 9 Kas 2026

authplane/ts-sdk · typescript · Apache-2.0

Authplane yetkilendirme tokenlarını kullanarak MCP server ve kaynak server'larını korumak için OAuth 2.1 ve JWT doğrulama bileşenleri sağlar.

Ayrıca bilinen adı AuthPlane/ts-sdk

Security Developer Tools

GitHub ↗

Yıldızlar: 7
Araçlar: —
İndirmeler, 30 gün: —
En son sürüm: —
Son commit: 9 Kas 2026
Lisans: Apache-2.0

Authplane TypeScript SDK MCP nedir?

Authplane TypeScript SDK bir MCP sunucusudur. Authplane yetkilendirme tokenlarını kullanarak MCP server ve kaynak server'larını korumak için OAuth 2.1 ve JWT doğrulama bileşenleri sağlar.

Özet, projenin README dosyasından oluşturuldu

Authplane TypeScript SDK MCP sunucusu hakkında

Bu TypeScript SDK'nın temel işlevi, MCP server ve kaynak server'larını Authplane yetkilendirme tokenları ile korumaktır. Geliştiricilere Node.js ortamları için tasarlanmış OAuth 2.1 ve JWT doğrulama bileşenleri sunar. Araç seti; resmi MCP TypeScript SDK, FastMCP, Hono ve NestJS için özelleşmiş adaptörler içererek mevcut web framework'lerine ve sunucu mimarilerine kolay entegrasyon sağlar.

Geliştiriciler bu paketleri; yalnızca asimetrik imzalama, DPoP kanıt doğrulaması ve iptal işlemleri için token incelemesi (introspection) gibi sıkı güvenlik önlemlerini uygulamak için kullanırlar. SDK, Node.js 22 LTS veya daha yeni bir sürüm gerektirir ve TypeScript kullanıcıları için belirli modül çözümleme ayarlarını destekler. Güvenilir ve güvenli kimlik doğrulama süreçleri sağlamak amacıyla SSRF sıkılaştırma, claim doğrulama ve yetkilendirme sunucusu etkileşimleri sırasında devre kesici (circuit breaking) gibi karmaşık güvenlik görevlerini yönetir.

Neler yapabilirsiniz

1Güvenli FastMCP server'larBir geliştirici, belirli issuer ve scope gereksinimlerine sahip authplaneFastMcpAuth fonksiyonunu kullanarak bir FastMCP server'ına kimlik doğrulama ekleyebilir.
2Gelişmiş güvenlik için DPoP uygulamasıSDK, DPoP standartlarını desteklemek için gelen kanıt doğrulaması ve giden kanıt oluşturma imkanı tanır.

Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.

Otomatik kontroller

Çalıştırıldı 15 Kas 2026Tam rapor →

58/100

Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği

Bu puanı README dosyanızda gösterin

Kaynak deposu bağlantılı ve erişilebilirauthplane/ts-sdk is public and reachablegithub.com/authplane/ts-sdk ↗Geçti
Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
Derleme kökeni (Sigstore onayı)Kontrol edilmedi
Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-09github.com/authplane/ts-sdk ↗Geçti
OpenSSF ScorecardKontrol edilmedi
Paket adı popüler bir pakete yakın değilKontrol edilmedi
Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
Yıkıcı araçlar etiketlenmişKontrol edilmedi
Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi

README

GitHub üzerinde görüntüle

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.

Tam README dosyasını oku

Authplane TypeScript SDK MCP soruları

SDK hangi framework'leri destekliyor?

SDK; Hono, NestJS, FastMCP ve resmi MCP TypeScript SDK için adaptörler içerir.

Bu SDK'yı kullanmak için Node.js gereksinimleri nelerdir?

Node.js 22 LTS veya daha yeni bir sürüm gereklidir.

Bilgiler

15 Kas 2026

Yıldızlar: 7
İndirmeler, 30 gün: —
En son sürüm: —
Son commit: 9 Kas 2026
Lisans: Apache-2.0
Taşıma: —
Paket: —

AuthPlane ↗

Topluluk yayıncısı

Bağımsız bir bakımcı tarafından yayınlandı.

AuthPlane tarafından daha fazlası →

Depo bağlantılı
Açık kaynak lisansı
Son 365 gün içinde etkin

Alternatifler

Şunlarla çalışır

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

README dosyanız için rozet

HostedMCP checks puanınızı gösterin. Rozet, okuyucuları her istemci için kurulum talimatlarına yönlendirir.

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

Bakımcı mısınız?

Bu kaydı düzenlemek ve README dosyanıza HostedMCP rozetini eklemek için kaydı sahiplenin.

Kaydı sahiplen

Yüklemeden önce

Sunucular onlara verdiğiniz izinlerle çalışır. İşi yapacak en dar kapsamlı token veya veritabanı rolünü kullanın.

Authplane TypeScript SDK MCP sunucusu hakkında

Neler yapabilirsiniz

1Güvenli FastMCP server'larBir geliştirici, belirli issuer ve scope gereksinimlerine sahip authplaneFastMcpAuth fonksiyonunu kullanarak bir FastMCP server'ına kimlik doğrulama ekleyebilir.
2Gelişmiş güvenlik için DPoP uygulamasıSDK, DPoP standartlarını desteklemek için gelen kanıt doğrulaması ve giden kanıt oluşturma imkanı tanır.

Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.

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