My Credentials MCP

🚀 🔐 My Credentials MCP Server

このサーバーは、Claude Desktopを通じて安全なデータベース操作と資格情報生成ツールを提供するModel Context Protocol (MCP)サーバーです。自然言語を使用してPostgreSQLデータベースと対話し、さまざまな種類の資格情報を生成できます。

✨ 主な機能

🗄️ データベース操作

• データベースクエリ：自然言語を介して読み取り専用のSQLクエリを実行
• データベース管理：挿入、更新、削除操作（ロールベースの権限付き）
• スキーマ探索：テーブル、列、および関係を自動的に探索
• 製品フィードバックシステム：組み込みの提案とバグ報告システム
• 拡張ツール説明：LLMの実行を改善するための包括的な例、テーブルスキーマ、およびSQLガイダンス

🔐 資格情報生成 (14のツール)

• 一意識別子：UUID4、ULID、Nano IDの生成
• パスワード：カスタマイズ可能な複雑性ルールを持つ安全なパスワード
• APIキー：さまざまな形式（16進数、base64、base64url）
• トークン：ベアラートークン、JWTシークレット、セッショントークン、CSRFトークン
• 暗号化要素：ソルト、IV、HMACキー、暗号化キー
• サービス固有：AWS資格情報、GitHubトークン、データベースパスワード
• バッチ操作：1回の操作で複数の資格情報を生成

🛡️ セキュリティ機能

• GitHub OAuth認証：単一ユーザーのアクセス制御
• SQLインジェクション保護：多層検証とサニタイズ
• ロールベースの権限：読み取り/書き込みアクセスレベルを分離
• HTTP APIラッパー：Cloudflare Workersの制限を回避
• 監査ログ：すべての操作をユーザーコンテキストとともに追跡

🆕 最近の機能強化 (v0.0.1)

🔧 バグ修正と安定性向上

• ✅ HTTP 500エラーの修正：submitProductSuggestion APIの競合を解消
• ✅ スキーマ登録：ZodスキーマのTypeScriptコンパイル問題を修正
• ✅ データベースパラメータ処理：HTTP APIラッパーのSQLクエリ処理を改善
• ✅ API統一：重複するHTTP実装を排除

📚 ドキュメントの強化

• 🎯 包括的なツール説明：各MCPツールに詳細なパラメータ説明、使用例、およびワークフローが含まれるようになりました
• 📊 完全なテーブルスキーマ：すべてのデータベーステーブルの完全な列定義と関係
• 🔍 SQLクエリ例：一般的な操作の実用的なPostgreSQL例
• ⚠️ ベストプラクティスガイド：セキュリティ警告、トラブルシューティングヒント、および最適化ガイダンス
• 💡 LLM最適化：強化された説明により、パラメータエラーが減少し、実行成功率が向上します

🏗️ アーキテクチャ

このMCPサーバーは、本番環境へのデプロイに最適化されたハイブリッドアーキテクチャを使用しています。

Claude Desktop → MCP Server (Cloudflare Workers) → HTTP API Wrapper → PostgreSQL

• MCPサーバー：グローバルな可用性のためにCloudflare Workersにデプロイ
• HTTP APIラッパー：接続制限を回避するExpress.jsサーバー
• データベース：コネクションプーリングとセキュリティ検証を備えたPostgreSQL

📋 データベーステーブル

コアテーブル

• local_credentials - 安全な資格情報の保存と管理
• complaints - AIエージェントの匿名フィードバックシステム
• product_improvement_suggestions - ユーザーのフィードバックと機能強化要求

🚀 開発者向けクイックスタート

前提条件

• Node.js 18以上
• PostgreSQLデータベース
• Cloudflareアカウント（無料プランで可）
• OAuth用のGitHubアカウント

1. リポジトリをクローン

git clone https://github.com/preangelleo/my-credentials-mcp.git
cd my-credentials-mcp
npm install

2. データベースのセットアップ

PostgreSQLデータベースをセットアップし、接続詳細をメモします。

# 接続文字列の例:
postgresql://username:password@hostname:5432/database_name

3. 環境変数の設定

.dev.varsファイルを作成します。

# GitHub OAuth設定
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret
COOKIE_ENCRYPTION_KEY=your_random_32_byte_key

# データベース設定
DATABASE_URL=postgresql://user:pass@host:5432/db

4. GitHub OAuthアプリの設定

1. GitHub Developer Settingsにアクセスします。
2. 新しいOAuthアプリを作成します。
   • ホームページURL：http://localhost:8792（開発用）
   • コールバックURL：http://localhost:8792/callback
3. クライアントIDとシークレットを.dev.varsにコピーします。

5. ユーザーアクセスの設定

src/tools/http-api-tools.tsの11行目を編集します。

const ALLOWED_USERNAMES = new Set<string>([
  'your-github-username'  // あなたのGitHubユーザー名に置き換えてください
]);

6. HTTP APIラッパーのデプロイ (推奨)

HTTP APIラッパーは、データベース接続の信頼性を向上させます。

# サーバー上でAPIラッパーをセットアップ
cd mcp-api-wrapper
cp .env.example .env
# .envにデータベース資格情報を設定
npm install
node server.js

7. Cloudflare Workersへのデプロイ

# Wrangler CLIをインストール
npm install -g wrangler

# Cloudflareにログイン
wrangler login

# OAuth用のKV名前空間を作成
wrangler kv namespace create "OAUTH_KV"
# 返された名前空間IDでwrangler.jsoncを更新

# 本番環境のシークレットを設定
wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY
wrangler secret put DATABASE_URL

# デプロイ
wrangler deploy

8. Claude Desktopに接続

Claude Desktopの設定に追加します。

{
  "mcpServers": {
    "my-credentials": {
      "command": "npx",
      "args": [
        "mcp-remote", 
        "https://your-worker-name.your-subdomain.workers.dev/mcp"
      ]
    }
  }
}

🛠️ 利用可能なMCPツール

データベースツール

• listTables - データベーススキーマと構造を探索
• queryDatabase - 読み取り専用のSQLクエリを実行
• executeDatabase - 書き込み操作を実行（特権ユーザーのみ）

製品フィードバックツール

• submitProductSuggestion - 改善提案またはバグ報告を送信
• getProductSuggestions - フィルターを使用してフィードバックを閲覧および検索
• updateSuggestionStatus - 提案のステータスを更新（開発者のみ）

資格情報生成ツール

• generateUuid - UUID4とULIDの生成
• generatePassword - 複雑性ルールを持つ安全なパスワードの生成
• generateApiKey - さまざまな形式のAPIキーの生成
• generateToken - ベアラー、JWT、セッション、CSRFトークンの生成
• generateCrypto - 暗号化要素（ソルト、キー、IV）の生成
• generateServiceCredential - サービス固有の資格情報の生成
• generateBatch - 1回の操作で複数の資格情報を生成
• [他に7つの生成ツール...]

💻 使用例

データベースクエリ

"What tables are in my database?"
"Show me all credentials created this week"
"Insert a new API key for the GitHub service"

資格情報生成

"Generate a secure password for production use"
"Create an API key for my web service" 
"Generate AWS credentials for deployment"

製品フィードバック

"Submit a bug report about the query timeout issue"
"Check the status of my feature requests"
"Browse suggestions for database improvements"

🔒 セキュリティに関する考慮事項

• 単一ユーザーアクセス：GitHubユーザー名を設定して排他的なアクセスを行います。
• 環境変数：コード内に資格情報をハードコードしないでください。
• SQL検証：SQLインジェクションに対する組み込み保護があります。
• HTTPSのみ：すべての通信は転送中に暗号化されます。
• 監査トレイル：すべての操作が完全にログに記録されます。

📚 開発

ファイル構造

src/
├── auth/           # GitHub OAuthの処理
├── database/       # データベース接続とセキュリティ
├── tools/          # MCPツールの実装
│   ├── database-tools.ts
│   ├── credential-generation-tools.ts
│   ├── http-api-tools.ts
│   └── register-tools.ts
└── types.ts        # TypeScriptの定義

mcp-api-wrapper/    # データベースアクセス用のHTTP APIラッパー

テスト

# 開発サーバーを実行
wrangler dev

# MCPインスペクターでテスト
npx @modelcontextprotocol/inspector@latest
# 接続先: http://localhost:8792/mcp

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 十分にテストします。
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEを参照してください。

🔗 リンク

• GitHubリポジトリ: https://github.com/preangelleo/my-credentials-mcp
• Model Context Protocol: https://modelcontextprotocol.io/introduction
• Cloudflare Workers: https://workers.cloudflare.com/
• Claude Desktop: https://claude.ai/download

⚠️ 重要な注意事項

• このサーバーは、GitHubアカウントを使用した単一ユーザーアクセス用に設計されています。
• 機密情報の設定には常に環境変数を使用してください。
• 本番環境にデプロイする前に、開発環境で十分にテストしてください。
• 本番環境のデプロイでは、定期的なセキュリティ監査を行うことをお勧めします。

Claude Desktopコミュニティのために❤️ で作成されました。