mcp-use 0.1.20 → 0.3.0

package/dist/src/oauth-helper.d.ts

@@ -0,0 +1,125 @@
+/**
+ * OAuth helper for browser-based MCP authentication
+ *
+ * This helper provides OAuth 2.0 authorization code flow support for MCP servers
+ * that require authentication, such as Linear's MCP server.
+ */
+export interface OAuthConfig {
+    clientId?: string;
+    redirectUri: string;
+    scope?: string;
+    state?: string;
+    clientName?: string;
+}
+export interface OAuthDiscovery {
+    issuer: string;
+    authorization_endpoint: string;
+    token_endpoint: string;
+    registration_endpoint?: string;
+    response_types_supported: string[];
+    grant_types_supported: string[];
+    code_challenge_methods_supported: string[];
+    token_endpoint_auth_methods_supported?: string[];
+}
+export interface ClientRegistration {
+    client_id: string;
+    client_secret?: string;
+    registration_access_token?: string;
+    registration_client_uri?: string;
+    client_id_issued_at?: number;
+    client_secret_expires_at?: number;
+}
+export interface OAuthResult {
+    access_token: string;
+    token_type: string;
+    expires_at?: number | null;
+    refresh_token?: string | null;
+    scope?: string | null;
+}
+export interface OAuthState {
+    isRequired: boolean;
+    isAuthenticated: boolean;
+    isAuthenticating: boolean;
+    isCompletingOAuth: boolean;
+    authError: string | null;
+    oauthTokens: OAuthResult | null;
+}
+export declare class OAuthHelper {
+    private config;
+    private discovery?;
+    private state;
+    private clientRegistration?;
+    constructor(config: OAuthConfig);
+    /**
+     * Get current OAuth state
+     */
+    getState(): OAuthState;
+    /**
+     * Check if a server requires authentication by pinging the URL
+     */
+    checkAuthRequired(serverUrl: string): Promise<boolean>;
+    /**
+     * Fallback heuristics for determining auth requirements when direct checking fails
+     */
+    private checkAuthByHeuristics;
+    /**
+     * Discover OAuth configuration from a server
+     */
+    discoverOAuthConfig(serverUrl: string): Promise<OAuthDiscovery | undefined>;
+    /**
+     * Register a new OAuth client dynamically
+     */
+    registerClient(_serverUrl: string): Promise<ClientRegistration>;
+    /**
+     * Generate authorization URL for OAuth flow
+     */
+    generateAuthUrl(serverUrl: string, additionalParams?: Record<string, string>): string;
+    /**
+     * Exchange authorization code for access token
+     */
+    exchangeCodeForToken(serverUrl: string, code: string, codeVerifier?: string): Promise<OAuthResult>;
+    /**
+     * Handle OAuth callback and extract authorization code
+     */
+    handleCallback(): {
+        code: string;
+        state: string;
+    } | null;
+    /**
+     * Start OAuth flow by opening popup window (similar to your implementation)
+     */
+    startOAuthFlow(serverUrl: string): Promise<void>;
+    /**
+     * Complete OAuth flow by exchanging code for token
+     */
+    completeOAuthFlow(serverUrl: string, code: string): Promise<OAuthResult>;
+    /**
+     * Reset authentication state
+     */
+    resetAuth(): void;
+    /**
+     * Set OAuth state (internal method)
+     */
+    private setState;
+    /**
+     * Generate a random state parameter for CSRF protection
+     */
+    private generateState;
+}
+/**
+ * Linear-specific OAuth configuration
+ */
+export declare const LINEAR_OAUTH_CONFIG: OAuthConfig;
+/**
+ * Helper function to create OAuth-enabled MCP configuration
+ */
+export declare function createOAuthMCPConfig(serverUrl: string, accessToken: string): {
+    mcpServers: {
+        linear: {
+            url: string;
+            authToken: string;
+            transport: string;
+        };
+    };
+};
+//# sourceMappingURL=oauth-helper.d.ts.map

package/dist/src/oauth-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-helper.d.ts","sourceRoot":"","sources":["../../src/oauth-helper.ts"],"names":[],"mappings":"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"}