使用说明
项目简介
本项目 '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 服务器。
安装步骤
- 安装 Docker: 确保你的机器上已经安装了 Docker 和 Docker Compose。如果还没有安装,请参考 Docker 官方文档进行安装。
- 克隆仓库: 将 'salesforce-mcp-docker' 仓库克隆到本地:
git clone https://github.com/Yusful33/salesforce-mcp-docker.git cd salesforce-mcp-docker - 构建 Docker 镜像 (可选): 如果你想自定义 Docker 镜像,可以执行构建命令。如果使用默认配置,可以跳过此步骤,直接使用预构建镜像或 Docker Compose 自动构建。
docker build -t salesforce-mcp-server . - 启动 Docker 容器: 使用 Docker Compose 启动 MCP 服务器容器:
或者使用 Docker 命令直接运行:docker-compose up -d
(假设你已经构建了名为 'salesforce-mcp-server' 的镜像,或者 Docker Compose 会自动构建)docker run -d --name salesforce-mcp-server -p 8080:8080 salesforce-mcp-server
服务器配置
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' 字段。
基本使用方法
- 启动 MCP 服务器: 按照上述安装步骤启动 Docker 容器,确保 MCP 服务器正常运行。
- 配置 MCP 客户端: 在你的 MCP 客户端应用中,添加上述服务器配置信息。
- 连接和使用: MCP 客户端应该能够连接到 Docker 部署的 Salesforce MCP Server,并利用其提供的资源、工具和 Prompt 模板等功能。具体使用方法请参考 Salesforce MCP Server 仓库的文档和 MCP 客户端的指南。
信息
分类
开发者工具