Authplane TypeScript SDK MCP server
Commit 9 Nov 2026Menyediakan primitif validasi OAuth 2.1 dan JWT untuk melindungi MCP server dan resource server menggunakan token otorisasi Authplane.
Juga dikenal sebagai AuthPlane/ts-sdk
- Stars
- 7
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 9 Nov 2026
- Lisensi
- Apache-2.0
Apa itu Authplane TypeScript SDK MCP?
Menyediakan primitif validasi OAuth 2.1 dan JWT untuk melindungi MCP server dan resource server menggunakan token otorisasi Authplane.
Ringkasan dibuat dari README proyek
Tentang Authplane TypeScript SDK MCP server
Fungsi utama dari TypeScript SDK ini adalah melindungi MCP server dan resource server menggunakan token otorisasi Authplane. SDK ini menyediakan primitif validasi OAuth 2.1 dan JWT yang dirancang khusus untuk lingkungan Node.js. Toolkit ini mencakup adapter khusus untuk official MCP TypeScript SDK, FastMCP, Hono, dan NestJS, sehingga memudahkan integrasi ke dalam web framework dan arsitektur server yang sudah ada.
Developer dapat menggunakan package ini untuk menerapkan langkah keamanan ketat seperti asymmetric-only signing, verifikasi DPoP proof, dan token introspection untuk proses pencabutan token (revocation). SDK ini memerlukan Node.js 22 LTS atau versi terbaru dan mendukung pengaturan module resolution tertentu bagi pengguna TypeScript. SDK ini menangani tugas keamanan kompleks seperti hardening SSRF, validasi claim, dan circuit breaking saat berinteraksi dengan authorization server untuk memastikan proses autentikasi yang andal dan aman.
Apa yang bisa Anda lakukan dengannya
- 1Mengamankan server FastMCPDeveloper dapat menambahkan autentikasi ke server FastMCP dengan menggunakan fungsi authplaneFastMcpAuth dengan persyaratan issuer dan scope tertentu.
- 2Implementasi DPoP untuk keamanan yang lebih tinggiSDK ini memungkinkan verifikasi inbound proof dan pembuatan outbound proof untuk mendukung standar DPoP.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauauthplane/ts-sdk is public and reachablegithub.com/authplane/ts-sdk ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-09github.com/authplane/ts-sdk ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang Authplane TypeScript SDK MCP
Framework apa saja yang didukung oleh SDK ini?
SDK ini menyertakan adapter untuk Hono, NestJS, FastMCP, dan official MCP TypeScript SDK.
Apa persyaratan Node.js untuk menggunakan SDK ini?
Anda memerlukan Node.js 22 LTS atau versi yang lebih baru.