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，这是一个用于调试和故障排除的工具。