🚀 Salesforce MCP 服务器

这是一个基于 Salesforce MCP 协议的工具，可与 Salesforce 集成。借助自然语言处理技术，它能对 Salesforce 中的对象和记录进行查询、修改与管理，极大简化了与 Salesforce 的交互流程。

🚀 快速开始

本工具可帮助你通过自然语言处理与 Salesforce 进行交互，简化操作流程。你可以按照下面的步骤进行安装和配置。

✨ 主要特性

• 基于 Salesforce MCP 协议实现，可与 Salesforce 无缝集成。
• 利用自然语言处理技术，支持对 Salesforce 中的对象和记录进行查询、修改和管理。
• 提供多种身份验证方式，包括用户名/密码认证和 OAuth2 认证。
• 支持在 Cursor IDE 和 Claude Desktop 中集成使用。

📦 安装指南

使用 npm 安装包：

# 使用 npm 安装包
npm install salesforce-mcp-server

📦 设置

身份验证方式

用户名/密码认证

需要配置以下环境变量：

• SALESFORCE_USERNAME：Salesforce 用户名或电子邮件
• SALESFORCE_PASSWORD：Salesforce 密码
• SALESFORCE_SECURITY_TOKEN：Salesforce 安全令牌

OAuth2 认证

需要配置以下环境变量：

• SALESFORCE_CLIENT_ID：注册应用时获取的客户端 ID
• SALESFORCE_CLIENT_SECRET：应用的密钥
• SALESFORCE_REDIRECT_URI：重定向 URI

📦 集成指南

在 Cursor IDE 中集成

1. 打开 Cursor IDE 的设置。
2. 导航到插件管理或扩展部分。
3. 搜索并安装 Salesforce MCP 插件。
4. 配置插件，输入相关环境变量。

在 Claude Desktop 中集成

1. 将配置文件 config.json 放置在相应的位置：
   • Windows：%APPDATA%\Claude Desktop\config.json
   • macOS：~/Library/Application Support/Claude Desktop/config.json
2. 确保配置文件包含以下内容：

{
    "salesforce": {
        "username": "your_salesforce_username",
        "password": "your_salesforce_password",
        "security_token": "your_security_token"
    }
}

💻 使用示例

基础用法

搜索对象

server.searchObjects("Account");

获取模式信息

server.getSchemaInfo("Account", "fields");

查询记录

server.queryRecords("SELECT Id, Name FROM Account WHERE CreatedDate = TODAY()");

🚧 开发

从源代码构建

# 克隆仓库
git clone git@github.com:yourusername/salesforce-mcp-server.git

# 进入目录
cd salesforce-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

🛠️ 故障排除

身份验证错误

• 确认凭据是否正确。
• 对于用户名密码认证，确保安全令牌有效。
• 对于 OAuth2 认证，检查客户端 ID 和密钥是否正确。

连接问题

• 检查 Salesforce 实例 URL 是否正确。
• 确保网络连接正常。
• 验证 API 访问权限。

Cursor IDE 集成问题

• 重启 Cursor IDE 后确认插件已加载。
• 使用开发者工具检查控制台输出。
• 确认全局安装了 npm 包。

Claude Desktop 集成问题

• 检查配置文件位置是否正确。
• 确保文件权限无误。
• 重启 Claude Desktop 后确认插件加载状态。
• 确保环境变量已正确设置。

🤝 贡献

欢迎贡献！请随意提交 Pull Request。

📄 许可证

本项目遵循 MIT 许可证，详细信息请查看 LICENSE 文件。

❓ 问题与支持

如需帮助或报告问题，请在 GitHub 仓库中创建 ISSUE。