Steel Brain

Steel Brain

为 AI Agent 提供钢材领域知识的 MCP 服务——涵盖牌号属性、替代判定和钢厂证书指南，并以 Agent 可调用的 MCP 工具形式提供。

也可通过 REST API 使用：https://api.steelbrain.dev。

---

MCP 服务

Steel Brain 是一个 Model Context Protocol 服务。它通过远程可流式传输的 HTTP（无需安装）或本地 stdio 暴露三个 MCP 工具：

MCP 工具	功能
grade_lookup	查询钢材牌号的属性、化学成分、形态、应用和可焊性。可解析别名（4140 = 42CrMo4 = SCM440；S355 = ST52）。
substitution_check	给定 from_grade、to_grade 和 application，返回判定结果（valid / conditional / invalid），并说明一种牌号能否替代另一种牌号。
cert_guide	根据牌号和用途查询适用的钢厂证书（EN 10204 3.1/3.2、船级社证书 ABS/DNV/LR/BV/NK）以及需要检查的内容。

远程（无需安装，免费）

将支持可流式传输 HTTP 的任意 MCP 客户端指向：

https://api.steelbrain.dev/mcp

{
  "mcpServers": {
    "steel-brain": { "type": "http", "url": "https://api.steelbrain.dev/mcp" }
  }
}

Claude Code：claude mcp add --transport http steel-brain https://api.steelbrain.dev/mcp

无需 API 密钥。为确保服务稳定，设有共享的每日调用上限。

本地（stdio）

pip install -r requirements.txt
python -m steel_brain.mcp_server

通过 stdio 传输启动 MCP 服务，可供任意 MCP 客户端使用（Claude Desktop、Claude Code 或任何兼容 MCP 的 Agent）。

MCP 客户端配置示例

{
  "mcpServers": {
    "steel-brain": {
      "command": "python",
      "args": ["-m", "steel_brain.mcp_server"]
    }
  }
}

使用官方 MCP SDK（mcp 包）构建，通过标准 MCP 工具接口注册三个工具。

---

为什么选择 Steel Brain

大模型会对钢材问题胡乱猜测。它们可能会告诉你，退火态 4140 可以替代预硬态 4140，导致整个项目报废。Steel Brain 提供由一位在职钢材贸易商构建、经人工核实的知识库，并会如实回答“知识库中没有”，而不是自信地猜测。

真正有价值的是替代和证书判定逻辑：

• 4140RB 替代 4140QT（退火态与预硬态）：无效，合金相同，热处理状态相反
• 海洋用途下，316L 替代 304L：无效，耐腐蚀等级不同
• EH36 用于 S355 结构用途：单向有效，反向有条件
• 压力用途下，无缝管与 ERW 管：绝不可互换

覆盖范围

涵盖碳钢、合金钢和不锈钢，共 23 个牌号。包括圆钢、空心钢和钢板、钢管。包含 39 条替代规则和 4 份证书指南。

REST API（MCP 的替代方案）

相同知识也可通过 REST API 使用：https://api.steelbrain.dev ：

curl "https://api.steelbrain.dev/v1/grade/4140QT" -H "X-API-Key: YOUR_KEY"
curl "https://api.steelbrain.dev/v1/substitution?from_grade=316L&to_grade=304L&application=machined" -H "X-API-Key: YOUR_KEY"

上线时提供免费套餐。联系方式：[email protected]

以诚实为设计原则

• 牌号属性：采用已发布标准（ASTM/EN/JIS/API/ABS）的范围值，并明确标注。
• 替代与证书判定逻辑：由贸易从业者核实，并提供注明日期的判定结果。
• 未知牌号：如实告知“知识库中没有”，绝不编造。

开发

一条命令即可完成本地测试设置：

make test

或直接运行：

bash scripts/test.sh

如果 .venv 尚不存在，此脚本会通过 python3 -m venv .venv 创建它，将 requirements.txt 安装到其中，设置 SB_SERVE_UNVERIFIED=1（测试套件需要此设置才能测试未经核实的知识库条目），然后运行 pytest。适用于 macOS 和 Linux。额外参数会传递给 pytest，例如 bash scripts/test.sh tests/test_gate2.py -v。

python -m pytest tests/    # 15 项测试（10 项验收测试 + 5 项领域安全防护测试）

许可证

代码：MIT（参见 LICENSE）。知识库（kb/）：专有（参见 NOTICE）。