Better Auth

🚀 更好的身份驗證 MCP 服務器

這是一款用於身份驗證管理的企業級解決方案，它能基於 AES - 256 加密保障憑證安全，支持多協議認證，還具備即時威脅檢測與防護功能，為企業身份驗證管理提供全面且可靠的服務。

🚀 快速開始

克隆並安裝

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

構建服務器

npm run build

帶自動重建功能的開發

npm run watch

✨ 主要特性

核心功能

• 🔐 基於 AES - 256 加密的憑證安全管控，為企業身份驗證提供堅實的安全基礎。
• ⚙️ 支持多協議認證（OAuth2、SAML、LDAP），滿足不同場景下的認證需求。
• 🛡️ 即時威脅檢測與防護，時刻保障系統安全。

核心工具

• analyze_project：分析項目結構，提供身份驗證設置建議，幫助用戶快速搭建合適的認證環境。
• setup_better_auth：使用項目 ID 和 API 密鑰配置認證提供者，簡化認證配置流程。
• analyze_current_auth：檢測現有 auth.js/next - auth 實現，方便用戶瞭解當前認證狀況。
• generate_migration_plan：生成分步遷移計劃，助力用戶從舊系統平穩遷移到本解決方案。

測試與安全

• test_auth_flows：驗證登錄、註冊、重置密碼和兩步驗證流程，確保認證流程的正確性和穩定性。
• test_security：執行符合 OWASP 標準的安全檢查，保障系統的安全性。
• analyze_logs：查看身份驗證系統日誌以發現潛在問題，及時排查安全隱患。
• monitor_auth_flows：即時監控認證活動，對異常情況及時響應。

可用資源

• better - auth://config：當前 Better - Auth 配置設置，方便用戶查看和調整系統配置。
• better - auth://logs：身份驗證系統日誌，為問題排查提供依據。

📦 安裝指南

通過 Smithery 安裝

要自動使用 Smithery 安裝 Better Auth MCP Server for Claude Desktop，請執行以下命令：

npx -y @smithery/cli install @nahmanmate/better-auth-mcp-server --client claude

要在 Claude Desktop 上使用，請添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "better-auth-mcp-server": {
      "type": "better-auth",
      "projectID": "your-project-id",
      "apiKey": "your-api-key"
    }
  }
}

💻 使用示例

基礎用法

項目設置

要在新項目中設置 Better Auth，請運行：

better-auth init

然後根據提示完成配置。

遷移指南

要從舊系統遷移身份驗證到 Better Auth，請參考文檔中的遷移指南。

📚 詳細文檔

配置

環境變量

# 必填
BETTER_AUTH_PROJECT_ID=your-project-id
BETTER_AUTH_API_KEY=your-api-key

# 可選
BETTER_AUTH_ENV=development|staging|production
LOG_LEVEL=info|debug|error

安全最佳實踐

1. API 密鑰管理
   • 將 API 密鑰存儲在環境變量中，避免密鑰洩露。
   • 定期輪換密鑰，增強系統安全性。
   • 每個環境使用不同的密鑰，實現環境隔離。
2. 訪問控制
   • 實現速率限制，防止惡意攻擊。
   • 配置 IP 白名單，限制訪問來源。
   • 應用最小權限原則，確保用戶僅擁有必要的權限。
3. 監控
   • 啟用審核日誌，方便後續審計和問題排查。
   • 監控認證失敗情況，及時發現異常活動。
   • 設置可疑活動警報，對潛在威脅快速響應。

調試

調試時，請運行以下命令：

npm run debug

更好的調試方法是使用 MCP Inspector，這是一個用於調試和故障排除的工具。