使用说明

项目简介

本项目 'salesforce-mcp-docker' 旨在通过 Docker 容器化技术,帮助用户快速部署和运行 Salesforce MCP Server。Salesforce MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端,用于为 LLM 应用提供上下文信息和功能支持。本项目简化了服务器的安装、配置和运行过程,让用户可以更专注于 MCP 服务器的功能使用和集成。

主要功能点

  • 快速部署 MCP 服务器: 通过 Docker 镜像,无需复杂的环境配置,即可一键部署 Salesforce MCP Server。
  • 容器化运行: 将 MCP 服务器运行在隔离的 Docker 容器中,提高系统稳定性和安全性。
  • 简化配置: 提供默认的 Docker 配置,用户可以根据需要进行自定义。
  • 易于集成: 方便 MCP 客户端连接和使用 Docker 部署的 MCP 服务器。

安装步骤

  1. 安装 Docker: 确保你的机器上已经安装了 Docker 和 Docker Compose。如果还没有安装,请参考 Docker 官方文档进行安装。
  2. 克隆仓库: 将 'salesforce-mcp-docker' 仓库克隆到本地:
    git clone https://github.com/Yusful33/salesforce-mcp-docker.git
    cd salesforce-mcp-docker
  3. 构建 Docker 镜像 (可选): 如果你想自定义 Docker 镜像,可以执行构建命令。如果使用默认配置,可以跳过此步骤,直接使用预构建镜像或 Docker Compose 自动构建。
    docker build -t salesforce-mcp-server .
  4. 启动 Docker 容器: 使用 Docker Compose 启动 MCP 服务器容器:
    docker-compose up -d
    或者使用 Docker 命令直接运行:
    docker run -d --name salesforce-mcp-server -p 8080:8080 salesforce-mcp-server
    (假设你已经构建了名为 'salesforce-mcp-server' 的镜像,或者 Docker Compose 会自动构建)

服务器配置

MCP 客户端需要配置连接到 MCP 服务器的信息。对于通过 Docker 部署的 Salesforce MCP Server,典型的配置信息如下 (JSON 格式):

{
  "serverName": "Salesforce MCP Server (Docker)",
  "command": "http://localhost:8080/jsonrpc",
  "args": [],
  "description": "连接到本地 Docker 部署的 Salesforce MCP Server,默认端口为 8080。",
  "transport": "http-json-rpc"
}

配置参数说明:

  • 'serverName': MCP 服务器的名称,可以自定义,方便在客户端识别。
  • 'command': MCP 客户端连接服务器的地址。 由于 Docker 容器将服务器端口 8080 映射到宿主机的 8080 端口,因此这里使用 'http://localhost:8080/jsonrpc'。 '/jsonrpc' 是 Salesforce MCP Server 默认的 JSON-RPC 接口路径。
  • 'args': 启动参数,对于 Docker 部署的服务器,通常不需要额外的启动参数。 这里留空即可。
  • 'description': 对该服务器配置的描述,方便用户理解其用途。
  • 'transport': 传输协议,Salesforce MCP Server 默认使用 'http-json-rpc'。

注意: 如果你的 Docker 端口映射或服务器配置有所不同,请相应地修改 'command' 字段。

基本使用方法

  1. 启动 MCP 服务器: 按照上述安装步骤启动 Docker 容器,确保 MCP 服务器正常运行。
  2. 配置 MCP 客户端: 在你的 MCP 客户端应用中,添加上述服务器配置信息。
  3. 连接和使用: MCP 客户端应该能够连接到 Docker 部署的 Salesforce MCP Server,并利用其提供的资源、工具和 Prompt 模板等功能。具体使用方法请参考 Salesforce MCP Server 仓库的文档和 MCP 客户端的指南。

信息

分类

开发者工具