概览
FreeChemDraw MCP Server 是 FreeChemDraw 面向 AI 智能体与开发者提供的托管化学工具服务。通过 Streamable HTTP MCP 或 REST API,可将已有化学结构转换、性质计算与二维绘图接入工作流。底层使用 RDKit,返回的是计算结果,并非实验测量值。
四个核心工具为 resolve_chemical、convert_structure、calculate_properties 和 render_structure。resolve_chemical 仅规范化输入的 SMILES,不提供化合物名称或 CAS 检索;其余结构操作支持 SMILES/MOL。二维绘图支持默认样式的 SVG/PNG,不支持 ACS 专用样式。
截至 2026-10-16,线上 capabilities 还列出已启用的可选工具 get_editor_link。该工具需用户明确同意临时存储后才能使用:结构临时加密存储,编辑器链接十分钟有效且只能兑换一次。它不是所有部署都启用的第五个核心工具。也可手动将 SMILES/MOL 导入 FreeChemDraw 编辑器。
GitHub 公开仓库提供官方使用文档和接入示例;服务端实现为私有维护。仓库公开不表示 MCP 核心实现开源,也不代表授予服务端代码许可证。
主要功能
- `resolve_chemical`:规范化 SMILES,返回分子式,可选返回分子性质。
- `convert_structure`:在 SMILES 与 MOL 之间转换;支持范围内保留立体化学,MOL 转 SMILES 会丢失坐标与注释。
- `calculate_properties`:计算分子式、分子量、精确质量、形式电荷、Wildman–Crippen LogP 和 TPSA。
- `render_structure`:生成默认样式的 SVG/PNG 二维结构图,结果包含 Base64 图像数据。
- `get_editor_link`:当前线上实例已启用的可选编辑器集成,需明确同意临时存储;链接十分钟有效、一次兑换。
使用场景
- 为 AI 智能体提供结构格式转换和计算性质,辅助核对已有分子结构。
- 在应用中生成分子二维图,并将结构手动导入 FreeChemDraw 编辑器继续编辑。
- 通过同一托管服务,为兼容 MCP 的客户端和直接调用 REST 的应用提供化学工具。
使用方式
使用支持远程 Streamable HTTP 的 MCP 客户端,配置服务地址 https://ai.freechemdraw.com/mcp。由客户端完成初始化和协议协商,先执行 tools/list,再调用已列出的工具。不同客户端的配置字段可能不同,不应把通用示例当作某款产品的认证配置。
例如,在客户端中调用 calculate_properties,参数为 {"structure":"CCO","input_format":"smiles"}。REST 接入则向 https://ai.freechemdraw.com/api/v1/properties/calculate 提交同样的 JSON,完整字段和结果格式以 OpenAPI 为准。
基本化学调用免费,匿名访问无需注册或 API Key。线上文档当前列出的限制为:每 IP 每分钟 20 个 HTTP 请求、每服务进程每分钟 120 个;最多 2 个并发化学操作,每次超时 10 秒;每结构最多 256 个原子;请求体最多 1 MiB;SMILES/MOL 最长分别为 16,384/262,144 个字符。图像每边为 64–2048 像素,总面积不超过 2,000,000 像素。初始化和工具发现也计入限额;遇到 HTTP 429,遵循 Retry-After 并退避重试。没有服务等级保证,也没有通过账号、积分或订阅提高化学调用配额的方案。有效限制以 线上文档 为准。
远程调用会把结构发送到服务端。按当前官方隐私说明,普通计算不持久化原始结构或图像,调用元数据保留 30 天;客户端和代理可能另有留存。创建编辑器链接前需说明临时存储并取得明确同意,然后传入 allow_temporary_storage=true。
来源与核查边界
本条目说明所链接项目来源中记载的能力。条目编辑更新不代表完成过运行测试、兼容性测试或科学性能评估。
查看编辑与核查政策