🧩 Agentforce MCP 統合サーバー

このリポジトリは、Model Context Protocol (MCP) クライアントおよび REST API アプリケーションを Python SDK を使用して LLM と統合するための統合ソリューションを提供します。

以下の2つの主要コンポーネントが含まれています。

1. MCP サーバー – MCP 互換クライアントが LLM/API と直接通信できるようにします。

2. FastAPI サーバー – LLM/API をプログラムから呼び出すための RESTful API エンドポイントを提供します。

どちらのサーバーも、統合チャネル全体でシームレスな接続性、安全な認証、一貫したパフォーマンスを確保するように構築されています。

📘 概要

このリポジトリには、異なる通信モード向けに設計された2つの主要なサーバーが実装されています。

• MCP サーバー MCP クライアントが標準化された Model Context Protocol を使用して LLM/API に接続できるようにします。これにより、サポートされている MCP クライアントやインスペクターを通じて、リアルタイムの対話と動的なツールアクセスが可能になります。

• FastAPI サーバー LLM/API への RESTful アクセスを提供し、単純な HTTP リクエストを使用して既存のシステムやアプリケーションに簡単に統合できるようにします。

どちらの実装も Agentforce Python SDK を利用して Salesforce および Agentforce バックエンドと通信し、信頼性と一貫性を確保しています。

Related MCP server: MCP Server Sample

⚙️ セットアップ手順

1. リポジトリのセットアップ

リポジトリをクローンし、必要な環境変数を設定します。

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

⚠️ 注意: これらの認証情報が LLM/API にアクセスするための有効な CRED に対応していることを確認してください。

2. 依存関係のインストール

以下のコマンドを使用して、必要なすべての Python 依存関係をインストールします。

pip install -r requirements.txt

これにより、Agentforce Python SDK を含む、MCP サーバーと FastAPI サーバーの両方に必要なすべてのライブラリがインストールされます。

🚀 サーバーの実行

🧠 MCP サーバーの起動

MCP サーバー（MCP クライアントおよびインスペクター用）を起動するには：

python ./src/serverllm.py

MCP サーバーが初期化され、MCP クライアントからの接続待機状態になります。

🌐 FastAPI サーバーの起動

REST API アクセス用の FastAPI サーバーを実行するには：

fastapi dev ./src/serverllm.py

これにより FastAPI アプリケーションの開発インスタンスが起動し、Agentforce エージェントと対話する REST エンドポイントが公開されます。

🔍 インスペクターサーバー（オプション）

MCP Inspector ツールを使用して MCP サーバーをテストおよびデバッグするには：

1. インスペクターサーバーを起動します：

   npx @modelcontextprotocol/inspector

2. インスペクターの Web インターフェースを開きます（デフォルトポート: http://localhost:5173 またはコンソールに表示されるポート）。

3. ホスト URL を使用して、実行中の MCP サーバーに接続します：

   https://localhost:8000/mcp

4. Tools タブに移動して、利用可能な MCP ツールを探索およびテストします。