返回首页

TopMat MCP 使用帮助

TopMat MCP 是一个专门为材料科学和计算设计的模型控制协议服务器，提供多种材料计算和问答功能。

🚀 快速开始

什么是 MCP？

MCP (Model Context Protocol) 是一个开放标准，允许 AI 助手安全地连接到外部数据源和工具。TopMat MCP 提供了材料科学相关的计算和问答服务。

支持的功能

  • 🧪 Point 平衡计算: 计算材料在特定条件下的平衡状态
  • 📈 Line 线性计算: 进行线性扫描计算
  • ❄️ Scheil 凝固计算: 模拟材料凝固过程
  • 🤖 钢铁 RAG 问答: 基于钢铁知识库的智能问答
  • 🔬 AL_IDME: 铝合金的组织结构和性能预测

🌐 网页端快速开始

下面用 5 步快速上手 Demo：界面操作简洁，适合第一次体验或演示场景。

1

打开聊天页面，点击右下角 "体验 MCP" 按钮开始交互

打开体验按钮
2

在顶部的工具列表中查看所有可用工具，使用开关启用或禁用需要的工具

工具列表与开关
3

输入框下方有两个示例提示：

  • 示例 A：从钢铁知识库检索并分析结果
  • 示例 B：调用计算核心（Point/Line/Scheil 等），提交计算任务
示例提示
4

若使用计算示例，请根据提示填写或让模型生成计算参数，提交后等待计算完成（通常需要几秒到几分钟，视任务复杂度而定）

提交计算任务

提交计算任务

等待并查询结果

等待并查询结果

5

计算或检索成功后，Demo 会展示结果并对关键点进行自动分析，必要时可下载或复制结果用于后续处理

展示和分析结果

小贴士： 如果长时间没有返回结果，请先在工具面板确认对应计算工具已启用；

📱 MCP 客户端连接方式

🔐 认证方式说明

重要提示： TopMat MCP 服务器现在使用 Bearer Token 认证方式。

在配置任何 MCP 客户端时，您需要：

  1. 获取有效的 Bearer Token（请联系管理员获取）
  2. 在客户端配置中添加认证头部：Authorization: Bearer YOUR_TOKEN
  3. 不同的客户端可能需要不同的配置方式来设置认证头部

1. Cherry Studio

步骤:

  1. 打开 Cherry Studio
  2. 进入 设置 → MCP → 添加
  3. 选择 从json导入
  4. 粘贴以下配置（注意将 YOUR_BEARER_TOKEN 替换为实际的 token）：
  5. ⚠️ 在 Cherry Studio 中，您可能需要在界面的认证/头部设置中手动添加 Authorization 头部
{
    "mcpServers":{
        "TopMat-MCP":{
            "name": "TopMat-MCP",
            "type": "streamableHttp",
            "description": "TopMat 材料计算和问答服务",
            "isActive": true,
            "baseUrl": "https://mcp.topmaterial-tech.com/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_BEARER_TOKEN"
            }
        }
    }
}

2. Cursor

步骤:

  1. 打开 Cursor
  2. 进入 文件 → 首选项 → Cursor Settings
  3. 找到 MCP 部分
  4. 点击 New MCP Server
  5. 添加以下配置（注意将 YOUR_BEARER_TOKEN 替换为实际的 token）：
  6. ⚠️ 在 Cursor 中，您需要在 MCP 服务器配置中添加 headers 字段来设置认证头部
{
  "mcpServers": {
    "TopMat-MCP": {
      "url": "https://mcp.topmaterial-tech.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BEARER_TOKEN"
      }
    }
  }
}

3. 其他 MCP 客户端

对于其他支持 MCP 的客户端，请使用以下基本配置：

⚠️ 注意：不同客户端的认证配置方式可能不同，请参考相应客户端的文档来设置 Authorization: Bearer YOUR_BEARER_TOKEN 头部

{
  "mcpServers": {
    "TopMat-MCP": {
      "url": "https://mcp.topmaterial-tech.com/mcp",
      "description": "TopMat 材料计算和问答服务",
      "headers": {
        "Authorization": "Bearer YOUR_BEARER_TOKEN"
      }
    }
  }
}

🧪 功能使用指南

Point 平衡计算

用途: 计算材料在特定温度、压力和成分下的平衡状态

使用示例:

请帮我计算 Fe-Cr-Ni 合金在 1000K 和 1atm 下的平衡状态，成分比例为 Fe:0.7, Cr:0.2, Ni:0.1

参数说明:

  • components: 组分列表 (如 ["Fe", "Cr", "Ni"])
  • composition: 成分组成 (如 {"Fe": 0.7, "Cr": 0.2, "Ni": 0.1})
  • temperature: 计算温度 (K)
  • pressure: 计算压力 (atm)
  • database: 数据库名称

Line 线性计算

用途: 进行线性扫描计算，分析材料性质随参数的变化

使用示例:

请帮我计算 Fe-Cr 合金从 800K 到 1200K 的温度扫描，成分比例为 Fe:0.8, Cr:0.2

参数说明:

  • components: 组分列表
  • start_composition: 起始成分
  • start_temperature: 起始温度 (K)
  • end_composition: 结束成分
  • end_temperature: 结束温度 (K)
  • steps: 计算步数
  • pressure: 计算压力 (atm)
  • database: 数据库名称

Scheil 凝固计算

用途: 模拟材料凝固过程，分析凝固路径和相变

使用示例:

请帮我计算 Al-Si 合金的 Scheil 凝固过程，成分比例为 Al:0.9, Si:0.1，起始温度 700K

参数说明:

  • components: 组分列表
  • composition: 成分组成
  • temperature: 起始温度 (K)
  • pressure: 计算压力 (atm)
  • database: 数据库名称

钢铁 RAG 问答

用途: 基于钢铁知识库进行智能问答

使用示例:

什么是马氏体？它的形成条件是什么？

参数说明:

  • input: 输入文本内容
  • user: 用户标识符 (可选，默认为 "default-user")
  • response_mode: 响应模式 ("blocking" 或 "streaming"，默认为 "blocking")

AL_IDME 铝合金预测

用途: 用户提供铝合金的成分和工艺，用于 Al 合金的组织结构以及性能预测

使用示例:

我想要进行 Al 合金的点计算，Al-Si-Mg 的原子分数为 0.94、0.05、0.01，温度设置为 40℃，并进行硬度预测。

参数说明:

  • input: 输入文本内容，包含成分和工艺信息
  • user: 用户标识符 (可选，默认为 "default-user")
  • response_mode: 响应模式 ("blocking" 或 "streaming"，默认为 "blocking")

🔧 故障排除

认证问题

问题: 认证失败，收到 401 Unauthorized 错误

解决方案:

  1. 确认 Bearer Token 是否有效且未过期
  2. 检查 Authorization 头部格式：应为 Authorization: Bearer YOUR_TOKEN
  3. 确认在客户端配置中正确设置了认证头部
  4. 联系管理员获取有效的 Bearer Token

连接问题

问题: 无法连接到 TopMat MCP 服务器

解决方案:

  1. 检查网络连接
  2. 确认服务器 URL 正确: https://mcp.topmaterial-tech.com/mcp
  3. 首先检查认证是否正常（参考上方认证问题排查）
  4. 检查防火墙设置
  5. 尝试重新启动 MCP 客户端

计算错误

问题: 计算任务失败

解决方案:

  1. 检查输入参数格式是否正确
  2. 确认成分比例总和为 1
  3. 检查温度和压力值是否在合理范围内
  4. 确认数据库名称正确

响应超时

问题: 计算任务响应时间过长

解决方案:

  1. 减少计算步数
  2. 简化计算模型
  3. 检查网络延迟
  4. 使用流式响应模式

工具管理问题

问题: 工具面板无法展开或工具状态异常

解决方案:

  1. 刷新页面重新连接
  2. 检查网络连接状态
  3. 确认 MCP 服务器连接正常
  4. 重新配置环境变量

问题: 某个工具无法调用

解决方案:

  1. 检查工具是否已启用
  2. 确认工具参数格式正确
  3. 查看工具调用日志
  4. 尝试重新连接服务器

🆘 获取帮助

技术支持

社区支持