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 许可证。