이 저장소는 모델 Context Protocol (MCP)를 사용하여 Ory 인증 및 액세스 제어를 통합하기위한 TypeScript 패키지를 포함합니다. 저장소는 모든 Ory MCP 프로젝트를 포함하기 위해 mcp-oauth-provider]에서 mcp]로 이름이 변경되었습니다.

패키지

@ory/mcp-oauth 프로바이더

Ory MCP의 OAuth 공급자의 TypeScript 구현은 Ory Network와 Ory Hydra를 백엔드 공급자로 지원합니다. 이 패키지는 MCP 서버와 Ory의 OAuth2.1 인증 시스템 간의 원활한 통합을 제공합니다.

** 키 기능:**

• Ory Network 및 Ory Hydra를 두 개 모두 지원
• PKCE와 OAuth2 인증 코드 흐름 처리
• 고객 등록 및 토큰 운영 관리
• 토큰 소개 및 검증 제공
• MCP 서버 인증과 원활하게 통합

설치:

상세한 문서 및 사용 예제의 경우, 패키지 README를 참조하십시오.

@ory/mcp-access 제어

Ory Network 액세스 제어 통합을위한 MCP 도구 정의를 제공하는 TypeScript 모듈. 이 모듈은 JWT 토큰, create/retrieve Ory identities를 검증하고 인증 세션을 관리합니다.

** 키 기능:**

• JWKS를 이용한 JWT 토큰 검증

Ory MCP (Model Context Protocol)

This repository contains TypeScript packages for integrating Ory authentication and access control with the Model Context Protocol (MCP). The repository has been renamed from mcp-oauth-provider to mcp to be inclusive of all Ory MCP projects.

Packages

@ory/mcp-oauth-provider

A TypeScript implementation of an OAuth provider for Ory MCP that supports both Ory Network and Ory Hydra as backend providers. This package provides seamless integration between MCP servers and Ory’s OAuth2.1 authentication system.

Key Features:

• Supports both Ory Network and Ory Hydra as backend providers
• Handles OAuth2 authorization code flow with PKCE
• Manages client registration and token operations
• Provides token introspection and verification
• Integrates seamlessly with MCP server authentication

Installation:

npm install @ory/mcp-oauth-provider

For detailed documentation and usage examples, see the package README.

@ory/mcp-access-control

A TypeScript module that provides MCP tool definitions for Ory Network access control integration. This module helps validate JWT tokens, create/retrieve Ory identities, and manage authentication sessions.

Key Features:

• JWT token validation using JWKS
• Configurable JWT audience and claim extraction
• Automatic identity creation/retrieval in Ory Network
• Password-based authentication with session management
• Session token validation for MCP middleware
• MCP tool definition generation

Installation:

npm install @ory/mcp-access-control

For detailed documentation and usage examples, see the package README.

Examples

OAuth Provider Example

The examples/oauth-provider-example/ directory contains a complete MCP server implementation that demonstrates how to use the @ory/mcp-oauth-provider package with Ory Network authentication.

Features demonstrated:

• Complete MCP server setup with Ory OAuth2.1 authentication
• Bearer token authentication middleware
• Project management tools
• Both Streamable HTTP and SSE transport support

Getting Started:

1. Set up your environment variables:

   ORY_PROJECT_URL=https://your-project.projects.oryapis.com
   ORY_PROJECT_API_KEY=your-api-key
   MCP_BASE_URL=http://localhost:3000
   SERVICE_DOCUMENTATION_URL=https://your-docs-url.com
   

2. Run the example server:

   cd examples/oauth-provider-example
   npm install
   npm start
   

For the complete implementation, see examples/oauth-provider-example/mcp-server.ts.

Repository History