real-mcp-server.py -MCP服务器与Salesforce集成
该项目建立了一个 MCP（模型上下文协议） 与之交互的服务器 赛富时 使用 FastMCP，它还集成了基本的天气工具（如原始脚本中所述）。它提供了一系列与Salesforce交互的工具，例如查询记录、创建和更新记录，同时还通过以下方式安全地使用环境变量 .env 文件夹。
先决条件
Python库
启动服务器之前，请确保已安装必要的库。这些措施包括：
httpx-用于异步HTTP请求。requests-用于同步HTTP请求。python-dotenv-用于管理环境变量。simple-salesforce-用于与Salesforce的REST API交互。fastmcp-模型上下文协议（MCP）的核心库。
安装所需库
运行以下命令以安装所有必要的依赖项：
pip install httpx requests python-dotenv simple-salesforce fastmcpSalesforce API凭据
确保你有一个 Salesforce开发人员帐户 并且您拥有Salesforce的以下凭据：
SF_TOKEN_URL（OAuth2令牌端点）SF_CLIENT_ID（Salesforce应用程序的客户端ID）SF_CLIENT_SECRET（Salesforce应用程序的客户端密码）
这些凭据将用于验证和连接到您的Salesforce实例。
创建一个 .env 项目根目录中的文件，内容如下：
SF_TOKEN_URL=https://your-salesforce-instance-url/oauth2/token
SF_CLIENT_ID=your-client-id
SF_CLIENT_SECRET=your-client-secret
SF_API_VERSION=63.0 # Optional, set your Salesforce API version运行MCP服务器
第一步：开发模式
要在开发模式下运行服务器（用于测试和调试），请使用以下命令：
mcp dev real-mcp-server.py --with requests --with simple_salesforce这将以开发模式启动服务器，确保必要的库(requests 和 simple_salesforce)可供服务器使用。
步骤2：安装服务器
一旦你开发或测试了你的服务器，你可以使用以下方式安装它：
mcp install real-mcp-server.py这将安装服务器并注册其所有工具、资源和提示。
步骤3：运行服务器（直接或通过MCP客户端，例如Claude Desktop或自定义MCP源）
要运行服务器，您可以使用以下命令之一：
- MCP传输（通过
mcp run):
mcp run real-mcp-server.py这将使用 MCP传输，它连接到支持MCP的任何兼容客户端。
- UVicon（通过
uv run):
uv run real-mcp-server.py这将使用以下命令启动服务器 乌维科恩，这在生产环境中提供了更好的性能。
______________________________________________________________________
运行自定义MCP客户端
您可以运行自定义MCP客户端（例如“realmcp-Client.py”）连接到您的MCP服务器。您的客户端必须实现连接和处理针对LLM（主机）的查询的所有逻辑。
uv run real-mcp-client.py real-mcp-server.py
服务器功能
服务器提供了几个与Salesforce交互的工具和资源。一些关键特征包括：
工具
salesforce_query：在Salesforce上运行SOQL查询。
- 例子：
salesforce_query("SELECT Id, Name FROM Account LIMIT 5")salesforce_create：将新记录插入Salesforce并返回其ID。
- 例子：
salesforce_create("Account", {"Name": "Test Account"})salesforce_update：更新Salesforce中的现有记录。
- 例子：
salesforce_update("Account", "001xxxxxx", {"Name": "Updated Account"})资源
get_record：从Salesforce获取记录sobject和record_id.
- 例子：
get_record("Account", "001xxxxxx")get_application_status：提供应用程序的系统状态信息。
- 例子：
get_application_status()提示
review_code：检查代码的提示，输出代码检查消息。
- 例子：
review_code("print('Hello, world!')")______________________________________________________________________
故障排除
- 缺少依赖关系：
如果遇到与缺少库相关的任何错误，请确保使用以下命令安装所有依赖项 pip install:
pip install httpx requests python-dotenv simple-salesforce fastmcp- Salesforce身份验证问题：
如果服务器无法通过Salesforce进行身份验证，请在 .env 归档并确保它们是正确的。
- 服务器未启动：
如果服务器启动不正常，请检查日志中与依赖关系相关的错误。确保正确加载了环境变量，并安装了所有必要的库。
______________________________________________________________________
贡献
如果您遇到任何错误或想增强服务器的功能，请随时打开问题或拉取请求。欢迎投稿！
______________________________________________________________________
许可证
该项目根据MIT许可证获得许可——请参阅 许可证 文件以获取详细信息。