MCP · API 接入指南
检索与构建接入
按结构和实验条件检索公开反应,将查询结果构建为数据集并下载,保留来源与引用。
检索使用 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。
结果范围
检索覆盖公开数据集最新已发布版本中完成索引的记录。结果保留来源;计算得到的键变化会标明依据。