🧩 Servidor de integración Agentforce MCP

Este repositorio proporciona una solución unificada para integrar clientes del Protocolo de Contexto de Modelo (MCP) y aplicaciones de API REST con LLM utilizando el SDK de Python.

Incluye dos componentes principales:

1. Servidor MCP – Permite que cualquier cliente compatible con MCP se comunique directamente con un LLM/API.

2. Servidor FastAPI – Ofrece puntos finales de API RESTful para invocar el LLM/API mediante programación.

Ambos servidores están diseñados para garantizar una conectividad fluida, una autenticación segura y un rendimiento constante en todos los canales de integración.

📘 Descripción general

El repositorio implementa dos servidores clave diseñados para diferentes modos de comunicación:

• Servidor MCP Permite que los clientes MCP se conecten a LLM/API utilizando el Protocolo de Contexto de Modelo estandarizado. Esto permite la interacción en tiempo real y el acceso dinámico a herramientas a través de clientes e inspectores MCP compatibles.

• Servidor FastAPI Proporciona acceso RESTful a LLM/API, lo que facilita la integración en sistemas o aplicaciones existentes mediante solicitudes HTTP simples.

Ambas implementaciones utilizan el SDK de Python de Agentforce para comunicarse con Salesforce y el backend de Agentforce, garantizando fiabilidad y coherencia.

Related MCP server: MCP Server Sample

⚙️ Instrucciones de configuración

1. Configuración del repositorio

Clone el repositorio y configure las variables de entorno necesarias:

git clone hhttps://github.com/rajpatidar35/custommcp
cd custommcp

⚠️ Nota: Asegúrese de que estas credenciales correspondan a una CRED válida para acceder a LLM/API.

2. Instalación de dependencias

Instale todas las dependencias de Python necesarias utilizando:

pip install -r requirements.txt

Esto instalará todas las bibliotecas necesarias tanto para los servidores MCP como para FastAPI, incluido el SDK de Python de Agentforce.

🚀 Ejecución de los servidores

🧠 Iniciar el servidor MCP

Para iniciar el servidor MCP (utilizado para clientes e inspectores MCP):

python ./src/serverllm.py

El servidor MCP se inicializará y esperará las conexiones entrantes de los clientes MCP.

🌐 Iniciar el servidor FastAPI

Para ejecutar el servidor FastAPI para el acceso a la API REST:

fastapi dev ./src/serverllm.py

Esto inicia una instancia de desarrollo de la aplicación FastAPI, exponiendo puntos finales REST que interactúan con los agentes de Agentforce.

🔍 Servidor Inspector (Opcional)

Para probar y depurar el servidor MCP utilizando la herramienta MCP Inspector:

1. Inicie el servidor Inspector:

   npx @modelcontextprotocol/inspector

2. Abra la interfaz web del Inspector (puerto predeterminado: http://localhost:5173 o como se muestra en la consola).

3. Conéctese a su servidor MCP en ejecución utilizando la URL del host:

   https://localhost:8000/mcp

4. Navegue a la pestaña Tools para explorar y probar las herramientas MCP disponibles.