Salesforce MCP Server

这是一个使用jsforce通过Salesforce的REST API进行交互的Model Context Protocol服务器实现。

通过Smithery安装

要通过Smithery自动安装适用于Claude Desktop的Salesforce服务器：

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

针对您的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"
  }
}

运行评估

评估包加载了一个mcp客户端，然后运行index.ts文件，因此在测试之间无需重新构建。您可以通过在npx命令前添加环境变量来加载它们。完整的文档可以在这里找到这里。

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/tools.ts

安全性

确保：

• 保持您的.env文件安全且从不提交它
• 在可能的情况下，在Salesforce中使用IP限制
• 定期轮换您的安全令牌
• 考虑为MCP服务器实施额外的身份验证

贡献

欢迎贡献！请提交改进的PR。

许可证

MIT 许可证

MIT 许可证

版权所有 (c) 2024 Kablewy, LLC

在此授权任何人免费获得本软件及其相关文档文件（以下简称“软件”）的权利，
不受限制地处理软件，包括但不限于以下权利：
使用、复制、修改、合并、发布、分发、再许可和/或销售
软件的副本，并允许接收软件的人这样做，但需遵守以下条件：

上述版权声明和本许可通知应包含在软件的所有
副本或主要部分中。

软件按“原样”提供，不附带任何形式的保证，无论是明示的还是暗示的，
包括但不限于对适销性、特定用途适用性和非侵权性的保证。
在任何情况下，作者或版权持有人都不对因软件或其使用或其他交易引起的任何索赔、损害或其他责任负责，
无论是合同行为、侵权行为或其他方式。