Agentforce MCP

🧩 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=
PASSWORD=
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

1. 打开检查器web界面（默认端口： http://localhost:5173 或如控制台所示）。

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

   https://localhost:8000/mcp

1. 导航到 工具 选项卡以探索和测试可用的MCP工具。

______________________________________________________________________