🚀 symbolica-mcp 服务器说明文档

symbolica-mcp 是一个科学计算协议服务器，允许 AI 工具（如 Claude）进行符号计算、数值计算和数据分析，并生成可视化图表。它特别适用于量子计算、激光物理、椭圆积分和其他复杂科学研究领域。

✨ 主要特性

• 多平台支持：支持 macOS、Linux 和 Windows 系统。
• 资源扩展性：支持多 GPU/CPU 并行计算，适应不同规模的科学计算任务。
• 可视化支持：集成了 Matplotlib 和 Seaborn 等数据可视化库，提供高质量的图形输出。

📦 安装指南

请参考 官方文档 了解详细的安装步骤和依赖项要求。

🚀 快速开始

启动服务

symbolica-mcp --port=8000

访问接口

通过 HTTP 或 WebSocket 协议连接到服务，具体 API 文档请参考 API 文档。

💻 使用示例

基础用法

数学运算示例

import symbolica_mcp as sm

result = sm.compute("integrate x^2", "latex")
print(result)

微分方程求解示例

from symbolica_mcp import DESolver

sol = DESolver.solve("dy/dx = y*(1 - y)", y0=0.5, steps=100)
DESolver.plot(sol)

量子计算示例

import qiskit as qk

provider = qk.AerProvider()
simulator = provider.get_backend('aer_simulator')
circuit = qk.QuantumCircuit(2)
circuit.h([0,1])
circuit.measure_all()

job = qk.execute(circuit, simulator)
result = job.result()
print(result.visualization.plot_circuit())

数据可视化示例

import matplotlib.pyplot as plt

plt.style.use('seaborn')
data = [1, 2, 3, 4, 5]
plt.hist(data, bins=5)
plt.show()

📚 详细文档

示例图库

激光物理实验结果

椭圆积分计算结果

故障排除

常见问题

1. 权限错误
   • 确保挂载目录存在且有正确的访问权限。
2. 图形文件未显示
   • 检查主机系统的路径：macOS/Linux 系统为 /tmp，Windows 系统为临时文件夹。
   • 确认 Docker 服务对挂载位置的写入权限。
   • 查看 MCP 工具的输出内容：
   • 使用 symbolica-mcp status 命令检查服务状态。

联系方式

如需帮助，请访问 GitHub 项目地址 提交问题或反馈建议。