better-auth-mcp-server MCP Server について
better-auth-mcp-server は、認証管理を目的とした MCP サーバーです。Better Auth を利用中または導入予定のプロジェクト向けに、プロジェクト分析、Better Auth の設定、auth.js や NextAuth からの移行計画、認証フローのテストを行うツールを提供します。
主な機能
- 01認証導入に向けたプロジェクト構造の分析
- 02Better Auth プロバイダーの設定
- 03既存の auth.js・next-auth 実装の検出
- 04段階的な移行計画の生成
- 05ログイン・登録・リセット・2FA フローのテスト
活用シーン
- 01next-auth プロジェクトから Better Auth への移行
- 02認証フローとセキュリティ設定の確認
- 03認証ログの確認と認証イベントの監視
MCP 対応
本プロジェクトは MCP サーバーであり、分析・設定・テスト・監視用のツールと、better-auth://config および better-auth://logs のリソースを MCP クライアントに公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
better-auth-mcp-server MCP サーバー
認証管理用の MCP サーバー
エンタープライズグレードの認証ソリューションが提供する機能:
- 🔐 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- ログイン/登録/リセット/2fa のフローを検証しますtest_security- OWASP に準拠したセキュリティチェックを実行しますanalyze_logs- 問題がないか認証システムのログを確認しますmonitor_auth_flows- 認証をリアルタイムで監視します
利用可能なリソース
better-auth://config- 現在の Better-Auth 設定better-auth://logs- 認証システムのログ
開発
クローンしてインストールします:
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
設定
環境変数
# 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
セキュリティのベストプラクティス
-
API キーの管理
- API キーは環境変数に保存します
- キーを定期的にローテーションします
- 環境ごとに異なるキーを使用します
-
アクセス制御
- レート制限を実装します
- IP 許可リストを設定します
- 最小権限の原則に従います
-
モニタリング
- 監査ログを有効にします
- 認証の失敗を監視します
- 不審なアクティビティに対するアラートを設定します
インストール
Smithery 経由でのインストール
Smithery 経由で Claude Desktop 用 Better Auth MCP Server を自動的にインストールするには:
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": {
"command": "node",
"args": ["/path/to/better-auth-mcp-server/build/index.js"],
"disabled": false,
"alwaysAllow": []
}
}
}
デバッグ
MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします:
npm run inspector
Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。
使用例
プロジェクトのセットアップ
// Initialize Better-Auth in your project
await mcp.useTool('setup_better_auth', {
projectPath: './my-next-app',
config: {
projectId: process.env.BETTER_AUTH_PROJECT_ID,
apiKey: process.env.BETTER_AUTH_API_KEY
}
});
// Test core authentication flows
await mcp.useTool('test_auth_flows', {
flows: ['login', 'register', '2fa']
});
Auth.js/NextAuth からの移行
// Analyze current auth implementation
await mcp.useTool('analyze_current_auth', {
projectPath: './my-next-app'
});
// Generate migration steps
await mcp.useTool('generate_migration_plan', {
projectPath: './my-next-app',
currentAuthType: 'next-auth'
});
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。