使用说明
项目简介
Symbolica MCP服务器是一个基于Model Context Protocol (MCP) 的后端服务,旨在为大型语言模型(LLM)客户端提供强大的科学计算能力。它允许AI,如Claude,执行符号数学运算、数值计算、数据分析、生成可视化图表,以及进行量子计算分析等复杂任务。该服务器特别适用于需要高级计算能力支持的科学研究和工程应用场景。
主要功能点
- 科学计算库支持: 内置NumPy, SciPy, SymPy, Pandas等流行的科学计算库,支持广泛的数学、统计和数据处理操作。
- 符号数学运算: 利用SymPy库进行符号推导、方程求解和微积分运算。
- 数据分析与处理: 使用Pandas进行数据清洗、转换和分析,支持统计建模和机器学习任务(scikit-learn)。
- 数据可视化: 集成Matplotlib和Seaborn,能够生成各种图表,直观展示计算结果和数据分析结果。
- 量子计算分析: 支持量子计算相关分析和模拟。
- 跨平台兼容: 自动检测并适配Windows、macOS和Linux操作系统,尤其针对配备Apple M系列芯片的Mac用户进行了优化。
- 容器化部署: 通过Docker镜像提供,易于安装、部署和管理,保证环境一致性。
安装步骤
- 安装 Docker: 确保您的系统已安装 Docker。如果未安装,请访问 Docker 官网 (https://www.docker.com) 下载并安装适合您操作系统的 Docker 版本。
- 拉取 Docker 镜像: 打开终端或命令提示符,运行以下命令从 Docker Hub 拉取 Symbolica MCP 服务器的镜像:
docker pull ychen94/computing-mcp:latest
服务器配置
要将 Symbolica MCP 服务器与 MCP 客户端(例如 Claude for Desktop)连接,您需要配置客户端以指定如何启动和连接到服务器。以下是针对 Claude for Desktop 的配置示例。您需要编辑 Claude 的配置文件,在 'mcpServers' 部分添加 Symbolica MCP 服务器的配置信息。
针对 macOS/Linux 用户的配置:
{ "mcpServers": { "computing-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "/tmp:/app/shared", "ychen94/computing-mcp:latest" ] } } }
- '"computing-mcp"': 服务器名称,您可以自定义,用于在客户端中标识该服务器。
- '"command": "docker"': 指定启动服务器的命令为 'docker'。
- '"args": [...]': 启动 Docker 容器的参数列表。
- '"run"': Docker 运行命令。
- '"-i"': 保持 STDIN 打开,即使未连接。
- '"--rm"': 容器退出后自动删除容器。
- '"-v", "/tmp:/app/shared"': 将宿主机的 '/tmp' 目录挂载到容器的 '/app/shared' 目录,用于共享文件,例如生成的图片会保存在宿主机的 '/tmp' 目录下。
- '"ychen94/computing-mcp:latest"': 使用的 Docker 镜像名称和标签。
针对 Windows 用户的配置:
{ "mcpServers": { "computing-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "%TEMP%:/app/shared", "ychen94/computing-mcp:latest" ] } } }
- 配置与 macOS/Linux 类似,主要区别在于 '-v' 参数中使用了 Windows 的临时文件夹环境变量 '%TEMP%'。
配置步骤 (Claude for Desktop):
- 打开 Claude for Desktop 应用程序。
- 进入设置 (Settings)。
- 找到开发者选项 (Developer),点击 "Edit Config" (编辑配置)。
- 将上述 JSON 配置代码添加到打开的配置文件中 (通常是 JSON 格式)。 如果 'mcpServers' 部分已存在,只需在其中添加 '"computing-mcp"' 的配置。
- 保存配置文件。
- 重新启动 Claude for Desktop 或重新加载配置 (如果客户端支持)。
基本使用方法
- 启动 MCP 服务器: 配置完成后,当 Claude 需要使用科学计算能力时,Claude 客户端会根据您提供的配置自动启动 Symbolica MCP 服务器 (Docker 容器)。
- 在 Claude 中使用: 在 Claude 的对话中,您可以指示 Claude 执行科学计算任务。例如,您可以要求 Claude 进行矩阵运算、解微分方程、绘制数据图表等。 您可以参考仓库 README.md 文件中提供的 "Examples" 部分,了解如何通过自然语言指令结合代码运行的方式,让 Claude 使用 Symbolica MCP 服务器完成各种科学计算任务。
- 查看结果: 计算结果会以文本形式返回到 Claude 对话中。如果任务生成了图片 (例如图表),图片文件会保存在您配置的共享目录中 (macOS/Linux 为 '/tmp' 目录,Windows 为临时文件夹)。 您可以根据 Claude 返回的信息找到图片文件并查看。
注意事项
- 确保 Docker 正在运行,并且您有权限运行 Docker 命令。
- 共享目录的配置 ('-v' 参数) 非常重要,它决定了计算结果 (特别是图片文件) 在哪里保存。请根据您的需求调整共享目录的路径。
- 如果遇到权限问题,请检查共享目录的读写权限。
信息
分类
AI与计算