Salesforce MCP Server

🚀 Salesforce MCP 服務器

Salesforce MCP 服務器是一個藉助 jsforce 通過 Salesforce 的 REST API 實現的 Model Context Protocol 服務器，可高效執行各類 Salesforce 操作。

🚀 快速開始

使用 Smithery 安裝

你可以通過 Smithery 自動將其安裝為 Claude 桌面版，具體命令如下：

npx -y @smithery/cli install salesforce-mcp-server --client claude

✨ 主要特性

• 🔍 執行 SOQL 查詢
• 📋 獲取對象元數據
• ➕ 創建、更新和刪除記錄
• 🔒 安全的身份驗證處理
• 🔄 即時數據訪問

📦 安裝指南

1. 克隆倉庫：將項目倉庫克隆到本地。
2. 配置環境變量：複製 .env.example 為 .env，並填入你的 Salesforce 憑據。
3. 安裝依賴：在項目根目錄下執行 npm install 安裝所需依賴。
4. 構建項目：運行 npm run build 進行項目構建。
5. 啟動服務：執行 npm start 啟動服務器。

💻 使用示例

該服務器暴露了以下功能，以下是具體使用示例：

基礎用法

query：執行 SOQL 查詢

{
  "name": "query",
  "parameters": {
    "query": "SELECT Id, Name FROM Account LIMIT 5"
  }
}

describe-object：獲取對象元數據

{
  "name": "describe-object",
  "parameters": {
    "objectName": "Account"
  }
}

create：創建新記錄

{
  "name": "create", 
  "parameters": {
    "objectName": "Contact",
    "data": {
      "FirstName": "John",
      "LastName": "Doe",
      "Email": "john.doe@example.com"
    }
  }
}

update：更新現有記錄

{
  "name": "update",
  "parameters": {
    "objectName": "Contact",
    "data": {
      "FirstName": "John",
      "LastName": "Doe",
      "Email": "john.doe@example.com"
    }
  }
}

delete：刪除記錄

{
  "name": "delete",
  "parameters": {
    "objectName": "Contact",
    "data": {
      "Id": "some_id"
    }
  }
}

📚 詳細文檔

安全注意事項

⚠️ 重要提示

• 務必確保所有敏感信息（如 API 密鑰）安全存儲。
• 使用 HTTPS 進行通信，保障數據傳輸安全。
• 定期更新依賴庫，以防範已知漏洞。
• 配置適當的身份驗證和授權機制，防止非法訪問。

貢獻指南

貢獻是歡迎的！請通過提交拉取請求改進項目。

📄 許可證

本項目採用 MIT License 進行授權。

MIT License

版權 (c) 2024 Kablewy, LLC

准許任何人獲取本軟件及關聯文檔文件副本（"軟件"），並免費使用、複製、修改、合併、發佈、分發、轉許可和/或出售該軟件，並允許獲得軟件副本的人這樣做，但需遵守以下條件：

本版權聲明和本許可聲明必須在所有軟件副本或其重要部分中包含。

軟件按“原樣”提供，不做任何形式的擔保，包括但不限於適銷性、特定用途的適用性和無侵權的明示或暗示保證。作者或版權所有者不對任何因使用、操作、改編、分發或以其他方式使用本軟件所引起的損害承擔責任。