Agentforce MCP集成服务器

提供统一的解决方案,通过Agentforce Python SDK集成Model Context Protocol (MCP)客户端和REST API应用程序与Agentforce代理,支持实时交互和RESTful访问。

  • by Mohit-Harsh
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Mohit-Harsh/AgentforceMCP

使用说明

🧩 MCP集成服务器代理

此存储库为集成提供了统一的解决方案 模型上下文协议(MCP) 客户和 REST API 应用程序与 代理商 使用 代理Python SDK.

它包括两个核心组成部分:

  1. MCP服务器 –允许任何兼容MCP的客户端直接与代理进行通信。
  2. FastAPI服务器 –提供RESTful API端点,用于以编程方式调用Agentforce代理。

这两台服务器都是为了确保无缝连接、安全身份验证和跨集成通道的一致性能而构建的。


📘 概述

该存储库实现了为不同通信模式设计的两个关键服务器:

  • MCP服务器 使MCP客户端能够使用标准化的模型上下文协议连接到代理。这允许通过支持的MCP客户端和检查器进行实时交互和动态工具访问。

  • FastAPI服务器 提供对Agentforce代理的RESTful访问,使其易于使用简单的HTTP请求集成到现有系统或应用程序中。

这两种实现都利用了 代理Python SDK 与Salesforce和Agentforce后端通信,确保可靠性和一致性。


⚙️ 安装说明

1.存储库设置

克隆存储库并配置所需的环境变量:

git clone https://github.com/Mohit-Harsh/AgentforceMCP.git
cd AgentforceMCP

创建一个 .env 文件位于项目根目录中,并包含以下凭据:

UNAME=<your-salesforce-username>
PASSWORD=<your-salesforce-password>
SECURITY_TOKEN=<your-salesforce-security-token>

⚠️ 注: 确保这些凭据对应于具有Agentforce访问权限的有效Salesforce用户。


2.依赖安装

使用以下命令安装所有必需的Python依赖项:

pip install -r requirements.txt

这将为MCP和FastAPI服务器安装所有必要的库,包括Agentforce Python SDK。


🚀 运行服务器

🧠 启动MCP服务器

要启动MCP服务器(用于MCP客户端和检查器):

python ./src/streamable-http/server.py

MCP服务器将初始化并监听传入的MCP客户端连接。


🌐 启动FastAPI服务器

要运行FastAPI服务器以进行REST API访问,请执行以下操作:

fastapi dev ./src/fastapi/server.py

这将启动FastAPI应用程序的开发实例,公开与代理交互的REST端点。


🔍 检查器服务器(可选)

使用以下工具测试和调试MCP服务器 MCP检查员 工具:

  1. 启动检查器服务器:

    npx @modelcontextprotocol/inspector
    
  2. 打开检查器web界面(默认端口: http://localhost:5173 或如控制台所示)。

  3. 使用主机URL连接到正在运行的MCP服务器:

    https://localhost:8000/mcp
    
  4. 导航到 工具 选项卡以探索和测试可用的MCP工具。