Sf MCP Server

🚀 Salesforce MCP 服務器

這是一個專為測試和開發打造的本地模擬服務器，它能夠對 Salesforce CLI 命令進行 mocking 操作，為開發者提供便捷的開發與測試環境。

🚀 快速開始

本服務器可幫助開發者在本地模擬 Salesforce CLI 命令，為開發和測試工作提供便利。以下是使用前的準備和操作步驟。

先決條件

• Node.js (v14 或更高版本)
• npm (v6 或更高版本)

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd mcp-server

2. 安裝依賴項：

npm install

3. 配置環境變量：

cp .env.example .env
# 編輯 .env 文件進行配置

使用方法

開發模式

npm run dev

生產模式

npm run build
npm start

測試

npm test

✨ 主要特性

• 模擬 Salesforce CLI 命令，方便本地測試與開發。
• 提供本地開發環境，減少對線上環境的依賴。
• 可配置端點，滿足不同的使用需求。
• 具備日誌記錄和錯誤處理功能，便於問題排查。
• 擁有安全功能，如 CORS、Helmet，保障系統安全。
• 環境基於配置，靈活可定製。

📦 安裝指南

克隆倉庫

git clone <repository-url>
cd mcp-server

安裝依賴

npm install

配置環境變量

cp .env.example .env
# 編輯 .env 文件進行配置

💻 使用示例

基礎用法

在開發模式下啟動服務器：

npm run dev

高級用法

在生產模式下，先進行構建，再啟動服務器：

npm run build
npm start

📚 詳細文檔

配置說明

服務器可通過環境變量在 .env 文件中進行配置：

API 端點

服務器模擬以下 Salesforce CLI 命令：

• 大綱測試執行
• 組織管理
• 包件管理
• 源代碼管理

🔧 技術細節

安全性

• 已啟用並可配置 CORS，防止跨域請求帶來的安全風險。
• 使用 Helmet 進行安全頭設置，增強服務器的安全性。
• 採用 API 密鑰身份驗證，確保只有授權用戶可以訪問。
• 進行請求驗證，過濾非法請求。
• 具備完善的錯誤處理機制，及時響應和處理異常情況。

日誌記錄

日誌輸出到：

• 控制檯（開發環境）
• error.log（錯誤日誌）
• combined.log（所有日誌）

🤝 貢獻指南

1. 叉倉庫
2. 創建功能分支
3. 提交你的更改
4. 推送到分支
5. 創建 Pull Request

📄 許可證

本項目採用 MIT 許可證。