mcp salesforce-lite
简单轻便的Salesforce MCP服务器，用于将AI助手连接到Salesforce数据。非常适合原型制作和小型项目。
](https://pypi.org/project/mcp-salesforce-lite/)   ](https://github.com/luvl/mcp-salesforce-lite/stargazers)
📦 从PyPI安装： pip install mcp-salesforce-lite
🔗 PyPI包： https://pypi.org/project/mcp-salesforce-lite/
📚 GitHub存储库： https://github.com/luvl/mcp-salesforce-lite
演示
查看MCP Salesforce Lite服务器与Claude Desktop的运行情况：
*该演示显示了Claude Desktop使用MCP服务器与Salesforce数据进行交互——无缝查询对象、检索记录和执行CRUD操作。*
概述
此MCP（模型上下文协议）服务器为Claude等AI助手提供了对Salesforce数据和操作的安全访问。它实现了MCP标准，以实现AI应用程序和Salesforce CRM之间的无缝集成。
特性
- 🔐 通过OAuth 2.0保护Salesforce身份验证
- 📊 访问Salesforce对象（帐户、联系人、商机等）
- 🔍 SOQL查询执行
- 📝 Salesforce记录上的CRUD操作
- 🛡️ 内置安全性和速率限制
- 🚀 易于设置和配置
快速使用
# Install the package
pip install mcp-salesforce-lite
# Use with Claude Desktop (recommended)
uvx --from mcp-salesforce-lite mcp-salesforce-lite
# Or run directly
mcp-salesforce-lite适用于： Claude Desktop，任何兼容MCP的人工智能助手
Claude Desktop快速入门
生产使用（推荐）
使用此MCP服务器的最简单方法是直接从PyPI安装它，并使用Claude Desktop进行配置。
步骤1：配置Claude桌面
将以下配置添加到您的Claude Desktop设置文件中：
配置文件位置：
- macOS/Linux：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json
配置：
{
"mcpServers": {
"salesforce-lite": {
"command": "uvx",
"args": [
"--from",
"mcp-salesforce-lite",
"mcp-salesforce-lite"
],
"env": {
"SALESFORCE_ACCESS_TOKEN": "your_access_token",
"SALESFORCE_INSTANCE_URL": "your_instance_url"
}
}
}
}步骤2：设置Salesforce凭据
替换配置中的环境变量：
SALESFORCE_ACCESS_TOKEN：您的Salesforce访问令牌SALESFORCE_INSTANCE_URL：您的Salesforce实例URL（例如。，https://yourcompany.my.salesforce.com)
步骤3：重新启动克劳德桌面
保存配置后，重新启动Claude Desktop。您应该看到一个锤子图标，表示工具可用。
步骤4：测试集成
试着问克劳德：
- “列出可用的Salesforce对象”
- “描述Account对象”
- “执行SOQL查询以获取最近的潜在客户”
先决条件
- Python 3.10或更高版本
- Salesforce开发人员/生产组织
- Salesforce中配置的已连接应用程序
开发设置
如果您想修改或贡献此MCP服务器，请按照以下开发设置说明进行操作。
安装
选项1：使用紫外线（建议用于开发）
# Install uv if you haven't already
brew install uv # macOS
# or
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/macOS
# Clone and install the server
git clone https://github.com/luvl/mcp-salesforce-lite.git
cd mcp-salesforce-lite
uv sync选项2：使用诗歌
git clone https://github.com/luvl/mcp-salesforce-lite.git
cd mcp-salesforce-lite
poetry installSalesforce开发设置
创建一个 .env 项目根目录中的文件：
SALESFORCE_ACCESS_TOKEN=your_access_token
SALESFORCE_INSTANCE_URL=your_instance_url用法
发展模式
首先，确保您的Salesforce凭据已在您的 .env 文件。
方法1：直接执行Python
# Run the server directly
python src/mcp_salesforce_lite/server.py方法二：用诗
# Run with Poetry
poetry run python src/mcp_salesforce_lite/server.py方法3：使用紫外线（推荐）
# Run with UV
uv run python src/mcp_salesforce_lite/server.pyMCP检验员测试
如果安装了MCP CLI，则可以测试服务器：
# Test with MCP Inspector
mcp inspector
# Or run in development mode
mcp dev src/mcp_salesforce_lite/server.py如何将服务器发布为Pip包
服务器可以通过PyPI使用包含的 pyproject.toml 配置。
可用工具
服务器提供了AI助手可以使用的以下工具：
查询工具
soql_query：执行SOQL查询（必须定义模式以仔细请求确认UPDATE和DELETE操作）search_records：使用限制和分页在多个对象中搜索记录get_record：通过具有限制和分页的ID检索特定记录
CRUD操作
create_record：创建新记录（确保先描述object，然后找到对象的引用字段）update_record：更新现有记录delete_record：删除记录
元数据工具
describe_object_definition：通过分页获取对象元数据和字段信息list_avail_objects：列出具有限制和分页的可用Salesforce对象
开发Claude桌面集成
如果您是从源代码开发或运行服务器，则可以使用以下替代配置：
💡 提示： 示例配置文件在 examples/ 目录：
examples/claude_config_direct.json-直接执行Pythonexamples/claude_config_poetry.json-诗歌执行examples/claude_config_uv.json-UV执行（推荐）
选项1：直接执行Python
{
"mcpServers": {
"salesforce-lite": {
"command": "python",
"args": ["/ABSOLUTE/PATH/TO/mcp-salesforce-lite/src/mcp_salesforce_lite/server.py"],
"env": {
"SALESFORCE_ACCESS_TOKEN": "your_access_token",
"SALESFORCE_INSTANCE_URL": "your_instance_url"
}
}
}
}选项2：诗歌执行
{
"mcpServers": {
"salesforce-lite": {
"command": "poetry",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/mcp-salesforce-lite",
"run",
"python",
"src/mcp_salesforce_lite/server.py"
],
"env": {
"SALESFORCE_ACCESS_TOKEN": "your_access_token",
"SALESFORCE_INSTANCE_URL": "your_instance_url"
}
}
}
}选项3:UV执行（建议用于开发）
{
"mcpServers": {
"salesforce-lite": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/mcp-salesforce-lite",
"run",
"python",
"src/mcp_salesforce_lite/server.py"
],
"env": {
"SALESFORCE_ACCESS_TOKEN": "your_access_token",
"SALESFORCE_INSTANCE_URL": "your_instance_url"
}
}
}
}项目结构
mcp-salesforce-lite/
├── src/
│ └── mcp_salesforce_lite/
│ ├── __init__.py
│ ├── server.py # Main MCP server
│ ├── client.py # Salesforce client wrapper
│ ├── config.py # Configuration management
│ └── tools/
│ ├── __init__.py
│ ├── query.py # SOQL query tools
│ ├── crud.py # Create, Read, Update, Delete tools
│ └── metadata.py # Object metadata tools
├── examples/
│ ├── basic_usage.py
│ └── claude_config.json
├── assets/
│ └── sf-demo.gif # Demo GIF showing usage
├── .env.example
├── pyproject.toml
├── poetry.lock
└── uv.lock发布
先决条件
- 注册PyPI生产首选https://pypi.org/account/register/
- 启用2FA：在您的帐户设置中设置双因素身份验证
- 创建API令牌首选https://pypi.org/manage/account/token/并创建令牌
- 更新.pypirc：替换
pypi-YOUR_PRODUCTION_TOKEN_FROM_PYPI_ORG_HERE用你的真实代币
出版流程
- 首先在TestPyPI上进行测试:
# Build the package
uv build
# or: poetry build
# Upload to TestPyPI
twine upload --repository testpypi --config-file .pypirc dist/*
# Test install from TestPyPI
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ mcp-salesforce-lite- 发布到生产PyPI:
# Upload to production PyPI
twine upload --repository pypi --config-file .pypirc dist/*
# Test install from production PyPI
pip install mcp-salesforce-lite版本管理
要发布新版本，请执行以下操作：
- 更新中的版本
pyproject.toml - 重建：
uv build或poetry build - 上传：
twine upload --repository pypi --config-file .pypirc dist/*