Kablewy Salesforce MCP Server

🚀 Salesforce MCP 服務器

這是一個基於 jsforce 並通過 Salesforce 的 REST API 實現的 Model Context Protocol 服務器，可助力用戶執行各類 Salesforce 操作，如查詢、數據增刪改等，提供便捷且安全的數據交互體驗。

🚀 快速開始

本服務器藉助 jsforce 和 Salesforce 的 REST API 實現，以下是啟動服務器的步驟：

1. 克隆倉庫
2. 複製 .env.example 到 .env 並填寫您的 Salesforce 憑據
3. 安裝依賴項：npm install
4. 構建：npm run build
5. 啟動：npm start

✨ 主要特性

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

💻 使用示例

基礎用法

服務器公開了幾個實用功能，以下是具體使用示例：

query

對您的 Salesforce 實例執行 SOQL 查詢：

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

describe-object

獲取有關 Salesforce 對象的元數據：

{
  "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": {
      "Id": "003XXXXXXXXXXXXXXX",
      "Email": "new.email@example.com"
    }
  }
}

delete

刪除記錄：

{
  "name": "delete",
  "parameters": {
    "objectName": "Contact",
    "id": "003XXXXXXXXXXXXXXX"
  }
}

📚 詳細文檔

安全

⚠️ 重要提示

• 保持 .env 文件安全且永遠不要提交它
• 儘可能使用 Salesforce 中的 IP 限制
• 定期輪換您的安全令牌
• 考慮為 MCP 服務器實現額外的身份驗證

貢獻

歡迎貢獻！請提交帶有改進的 PR。

📄 許可證

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.