simple-salesforce-mcp

一个轻量级的 Salesforce MCP 服务器。它通过 stdio 直接与 Salesforce REST API 通信，仅有两个运行时依赖（mcp、httpx）——旨在作为官方 @salesforce/mcp DX 服务器的快速冷启动替代品，后者的依赖树对于沙盒环境来说过于庞大。

工具

每个工具都带有 MCP 注解（readOnlyHint / destructiveHint / idempotentHint）。 update_record 和 delete_record 拒绝执行，除非调用包含 confirm: true， 并且拒绝消息会指示模型先将确切的更改展示给用户并获得批准。 SOQL 本身无法修改数据，因此该逃生通道保持只读。

Related MCP server: Salesforce MCP Server

身份验证

服务器本身不执行 OAuth 流程；它使用现有的访问令牌，该令牌在每次工具调用时解析（因此外部进程可以随时轮换令牌）：

1. Salesforce CLI 认证存储，位于 $HOME 下：

   • ~/.sf/config.json → {"target-org": "<username>"}（或旧版 ~/.sfdx/sfdx-config.json → {"defaultusername": ...}）

   • ~/.sfdx/<username>.json → {"accessToken": "...", "instanceUrl": "https://..."}

   这是 sf org login 写入的格式，也是 JustParent 平台在沙盒中生成的格式（平台会在每次调用前刷新访问令牌）。这些文件中的刷新令牌和客户端密钥会被忽略——绝不会读入内存、存储或记录。

2. 环境变量（备用，用于本地/独立使用）： SALESFORCE_ACCESS_TOKEN 和 SALESFORCE_INSTANCE_URL。

当令牌被拒绝（HTTP 401 / INVALID_SESSION_ID）时，服务器会重新读取认证存储一次并重试，然后报告连接需要重新建立。

REST API 版本默认为 62.0；可通过 SALESFORCE_API_VERSION 覆盖。

运行

# Standalone with env vars (get a token via: sf org display --json)
SALESFORCE_ACCESS_TOKEN=... \
SALESFORCE_INSTANCE_URL=https://yourorg.my.salesforce.com \
uvx --from git+https://github.com/JustParent/simple-salesforce-mcp simple-salesforce-mcp

Claude Desktop / 通用 MCP 客户端配置：

{
  "mcpServers": {
    "salesforce": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/JustParent/simple-salesforce-mcp", "simple-salesforce-mcp"],
      "env": {
        "SALESFORCE_ACCESS_TOKEN": "...",
        "SALESFORCE_INSTANCE_URL": "https://yourorg.my.salesforce.com"
      }
    }
  }
}

冒烟测试（无需网络，打印版本、凭据状态和工具；退出码为 0）：

uvx --from . simple-salesforce-mcp --test

开发

uv run pytest                    # unit tests, no network needed
uv run ruff check .              # lint
uv run ruff format .             # format (--check to verify only)
uv run mypy                      # type check (src and tests)
uv run simple-salesforce-mcp --test
npx @modelcontextprotocol/inspector uv run simple-salesforce-mcp   # interactive

CI（.github/workflows/tests.yml）在每次推送和拉取请求时运行：针对 Python 3.10–3.13 的测试套件、ruff lint 和格式检查以及 mypy，还有一个打包任务，它会以沙盒的方式安装该包（uvx --from .），以捕获打包问题。

安全说明

• 仅使用访问令牌：服务器从不请求、读取或持久化刷新令牌。

• 破坏性操作（update/delete）受显式 confirm=true 参数门控， 并带有面向模型的指引，要求先获得用户批准。

• SOQL 分页游标（next_url）会被验证为 /services/data/... 路径， 对象/记录标识符在放入 URL 之前也会经过验证。

• 响应有大小上限，并带有明确的截断提示。