MCP · API 接入指南

检索与构建接入

按结构和实验条件检索公开反应,将查询结果构建为数据集并下载,保留来源与引用。

创建 API Key

检索使用 reactions:read 权限;规划与构建数据集时再启用 construction:write。

MCP 连接配置

连接到你的 AI 客户端

Streamable HTTP · Bearer

在支持远程 MCP 的客户端添加以下服务地址和 Authorization 请求头。客户端配置格式可能不同,下面提供常见的 mcpServers 示例。

https://your-isynth-host/api/mcp
{
  "mcpServers": {
    "isynth": {
      "url": "https://your-isynth-host/api/mcp",
      "headers": {
        "Authorization": "Bearer <ISYNTH_AUTOMATION_TOKEN>"
      }
    }
  }
}

将占位符替换为 iSynth MCP 访问凭证,不是模型 API Key。已有凭证不能再次读取,遗失时请撤销并新建。

检索示例

在网页中运行

以下为 tools/call 的 params;MCP 客户端负责协议初始化和消息封装。

{
  "name": "search_reactions",
  "arguments": {
    "query": {
      "component_constraints": [
        {
          "role": "reactant",
          "mode": "substructure",
          "structure": "c1ccccc1Br"
        },
        {
          "role": "product",
          "mode": "substructure",
          "structure": "c1ccccc1N"
        }
      ],
      "bond_changes": [
        {
          "change": "broken",
          "elements": [
            "C",
            "Br"
          ],
          "role": "reactant",
          "component_slot": 1,
          "component_bond": [
            5,
            6
          ],
          "fragment_scope": "bond",
          "fragment": "[#6]:[#6](:[#6])-[#35]",
          "fragment_bond": [
            1,
            3
          ]
        },
        {
          "change": "formed",
          "elements": [
            "C",
            "N"
          ],
          "role": "product",
          "component_slot": 2,
          "component_bond": [
            5,
            6
          ],
          "fragment_scope": "bond",
          "fragment": "[#6]:[#6](:[#6])-[#7]",
          "fragment_bond": [
            1,
            3
          ]
        }
      ],
      "expand_aliases": true,
      "page_size": 5
    }
  }
}

检索与构建的衔接

当前公开 MCP 工具用于反应检索、查看来源及文件贡献。需要规划、构建或下载数据包时,使用网页或切换到 API;构建前需明确同意数据使用协议。

search_reactions → get_reaction
Only when needed: get_search_schema(topic=bonds|conditions|parameters)
Unfamiliar fields: get_search_fields; custom parameters: get_search_parameters
get_public_index_status (index coverage, when needed)

条件如何匹配

结构与键变化

所画结构限定匹配环境,键标记指定变化位置。断键标在反应物上,成键标在产物上。官能团可匹配同一分子的任意位置。

温度、时间与产率

报告值或区间与查询范围重叠即可匹配。温度和时间须在同一操作阶段满足;室温记录按页面选择纳入。

自定义字段

从公开数据中发现新增列和 JSON 参数,按实际值提供数值、文字或是/否筛选。已知单位统一换算;类型混杂时保留文字。同名字段按来源区分,跨文件合并需确认含义一致。

调用 get_search_parameters 获取当前字段、类型、单位和可用关系,再传入 parameter_filters。

结果范围

检索覆盖公开数据集最新已发布版本中完成索引的记录。结果保留来源;计算得到的键变化会标明依据。