Better Auth MCP Server

🚀 Better Authentication - MCP Server

An enterprise-level solution for authentication management, offering secure credential management, multi-protocol authentication, and real-time threat detection and protection.

This is an enterprise-level solution for authentication management, providing:

• 🔐 Secure credential management based on AES-256 encryption
• ⚙️ Multi-protocol authentication (OAuth2, SAML, LDAP)
• 🛡️ Real-time threat detection and protection

✨ Features

Core Tools

• analyze_project - Analyze the project structure and provide authentication setup suggestions
• setup_better_auth - Configure the authentication provider using the project ID and API key
• analyze_current_auth - Detect the existing auth.js/next-auth implementation
• generate_migration_plan - Create a step-by-step migration plan

Testing and Security

• test_auth_flows - Verify the login/registration/reset/two-factor authentication flows
• test_security - Perform security checks compliant with OWASP standards
• analyze_logs - Check for issues in the authentication system logs
• monitor_auth_flows - Monitor the authentication flows in real-time

Available Resources

• better-auth://config - Current Better-Auth configuration settings
• better-auth://logs - Authentication system logs

🚀 Quick Start

Development

Clone and install:

git clone https://github.com/better-auth-mcp-server/better-auth-mcp-server.git
cd better-auth-mcp-server
npm install

Build the server:

npm run build

Development with automatic rebuild:

npm run watch

Configuration

Environment Variables

# Required
BETTER_AUTH_PROJECT_ID=Your Project ID
BETTER_AUTH_API_KEY=Your API Key

# Optional
BETTER_AUTH_ENV=development|staging|production
LOG_LEVEL=info|debug|error

Security Best Practices

1. API Key Management

   • Store API keys in environment variables.
   • Rotate keys regularly.
   • Use different keys for each environment.

2. Access Control

   • Implement rate limiting.
   • Configure an IP whitelist.
   • Apply the principle of least privilege.

3. Monitoring

   • Enable audit logging.
   • Monitor authentication failures.
   • Set up alerts for suspicious activities.

Installation

Installation via Smithery

To automatically install the Better Auth MCP Server via Smithery:

better-auth install --server=@nahmanmate/better-auth-mcp-server

Debugging

Better Auth provides a debugging tool called better-auth-inspector for analyzing logs and configurations.

Installation:

npm install -g better-auth-inspector

Usage:

better-auth-inspector

💻 Usage Examples

Project Setup

1. Configuration File (config/auth.ts)

export default {
  providers: [
    {
      name: 'github',
      clientId: process.env.GITHUB_CLIENT_ID,
      clientSecret: process.env.GITHUB_CLIENT_SECRET,
    },
  ],
  secret: process.env.SECRET,
}

2. Start the Application

better-auth start

Migration Steps

1. Install Dependencies

npm install better-auth-mcp-server

2. Configure Environment Variables

export BETTER_AUTH_PROJECT_ID=your_project_id
export BETTER_AUTH_API_KEY=your_api_key

3. Start the Server

better-auth-mcp-server start