My Credentials MCP

🚀 🔐 我的憑證MCP服務器

這是一個專為Claude Desktop提供安全數據庫操作和憑證生成工具的服務器。它基於模型上下文協議（MCP），能讓你通過自然語言與PostgreSQL數據庫交互，並生成各類憑證。

🚀 快速開始

開發者必備條件

• 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 開發者設置
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"
      ]
    }
  }
}

✨ 主要特性

🗄️ 數據庫操作

• 查詢數據庫：通過自然語言執行只讀 SQL 查詢
• 數據庫管理：插入、更新、刪除操作（基於角色的權限控制）
• 模式發現：自動發現表、列和關係
• 產品反饋系統：內置建議和錯誤報告系統
• 增強的工具描述：提供全面的示例、表結構和 SQL 指導，以優化大語言模型（LLM）的執行

🔐 憑證生成（14 種工具）

• 唯一標識符：生成 UUID4、ULID、Nano ID
• 密碼：生成具有可定製複雜度規則的安全密碼
• API 密鑰：支持多種格式（十六進制、Base64、Base64URL）
• 令牌：生成 Bearer 令牌、JWT 密鑰、會話令牌、CSRF 令牌
• 加密元素：生成鹽、初始化向量（IV）、HMAC 密鑰、加密密鑰
• 特定服務憑證：生成 AWS 憑證、GitHub 令牌、數據庫密碼
• 批量操作：一次生成多個憑證

🛡️ 安全特性

• 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 - 用戶反饋和改進請求

🛠️ 可用的 MCP 工具

數據庫工具

• listTables - 發現數據庫模式和結構
• queryDatabase - 執行只讀 SQL 查詢
• executeDatabase - 執行寫操作（僅限特權用戶）

產品反饋工具

• submitProductSuggestion - 提交改進建議或錯誤報告
• getProductSuggestions - 瀏覽和篩選反饋
• updateSuggestionStatus - 更新建議狀態（僅限開發者）

憑證生成工具

• generateUuid - 生成 UUID4 和 ULID
• generatePassword - 生成具有複雜度規則的安全密碼
• generateApiKey - 生成多種格式的 API 密鑰
• generateToken - 生成 Bearer、JWT、會話、CSRF 令牌
• generateCrypto - 生成加密元素（鹽、密鑰、IV）
• generateServiceCredential - 生成特定服務的憑證
• generateBatch - 一次生成多個憑證
• [還有 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
• 模型上下文協議：https://modelcontextprotocol.io/introduction
• Cloudflare Workers：https://workers.cloudflare.com/
• Claude Desktop：https://claude.ai/download

⚠️ 重要提示

• 本服務器設計為通過你的 GitHub 賬戶實現單用戶訪問
• 始終使用環境變量存儲敏感配置
• 在生產環境部署前，務必在開發環境進行全面測試
• 建議定期對生產環境進行安全審計

為 Claude Desktop 社區精心打造 ❤️