🧩 Сервер интеграции Agentforce MCP

Этот репозиторий предоставляет унифицированное решение для интеграции клиентов Model Context Protocol (MCP) и приложений REST API с LLM с использованием Python SDK.

Он включает два основных компонента:

1. MCP Server – позволяет любому MCP-совместимому клиенту напрямую взаимодействовать с LLM/API.

2. FastAPI Server – предоставляет конечные точки RESTful API для программного вызова LLM/API.

Оба сервера созданы для обеспечения бесперебойного подключения, безопасной аутентификации и стабильной производительности по всем каналам интеграции.

📘 Обзор

В репозитории реализованы два ключевых сервера, предназначенных для различных режимов связи:

• MCP Server Позволяет клиентам MCP подключаться к LLM/API с использованием стандартизированного протокола Model Context Protocol. Это обеспечивает взаимодействие в реальном времени и динамический доступ к инструментам через поддерживаемые клиенты и инспекторы MCP.

• FastAPI Server Предоставляет RESTful-доступ к LLM/API, упрощая интеграцию в существующие системы или приложения с помощью простых HTTP-запросов.

Обе реализации используют Agentforce Python SDK для связи с Salesforce и бэкендом Agentforce, обеспечивая надежность и согласованность.

Related MCP server: MCP Server Sample

⚙️ Инструкции по настройке

1. Настройка репозитория

Клонируйте репозиторий и настройте необходимые переменные окружения:

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

⚠️ Примечание: Убедитесь, что эти учетные данные соответствуют действительным CRED для доступа к LLM/API.

2. Установка зависимостей

Установите все необходимые зависимости Python с помощью:

pip install -r requirements.txt

Это установит все необходимые библиотеки как для серверов MCP, так и для FastAPI, включая Agentforce Python SDK.

🚀 Запуск серверов

🧠 Запуск MCP Server

Чтобы запустить сервер MCP (используется для клиентов и инспекторов MCP):

python ./src/serverllm.py

Сервер MCP инициализируется и будет ожидать входящих подключений от клиентов MCP.

🌐 Запуск FastAPI Server

Чтобы запустить сервер FastAPI для доступа через REST API:

fastapi dev ./src/serverllm.py

Это запустит экземпляр приложения FastAPI для разработки, открывая конечные точки REST, которые взаимодействуют с агентами Agentforce.

🔍 Сервер инспектора (опционально)

Для тестирования и отладки сервера MCP с помощью инструмента MCP Inspector:

1. Запустите сервер инспектора:

   npx @modelcontextprotocol/inspector

2. Откройте веб-интерфейс инспектора (порт по умолчанию: http://localhost:5173 или как указано в консоли).

3. Подключитесь к запущенному серверу MCP, используя URL хоста:

   https://localhost:8000/mcp

4. Перейдите на вкладку Tools, чтобы изучить и протестировать доступные инструменты MCP.