Skip to content
UnveilChem 技术文档

快速开始

快速开始

本页带你用最短路径完成 ChemFlow MCP 的首次调用：领取 API Key → 验证服务连通 → 调用一个工具。

第一步：领取 API Key

ChemFlow MCP 提供免费层级（每日 1000 次调用），通过微信公众号自助领取：

  1. 微信搜索并关注公众号 UnveilChem
  2. 点击菜单「客户服务 → 我的 Key 与用量」
  3. 首次进入按页面提示领取免费 Key（格式为 cf_ 前缀的字符串）
  4. 同一页面可随时查看当日用量、剩余配额与最近调用记录

免费 Key 的配额与限流说明见 配额与限流。如需更高配额（Pro 层级每日 100,000 次），可通过公众号「购买 ChemFlow Pro」菜单或主站联系我们页面咨询。

第二步：验证服务连通

initialize 为免认证方法，可先不带 Key 验证服务可达：

Terminal window
curl -X POST https://unveilchem.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "my-client", "version": "1.0.0" }
    }
  }'

返回 HTTP 200 且响应包含 serverInfo（chemflow_mcp）即表示服务连通正常。

第三步：调用第一个工具

携带 API Key 查询水的物性数据（Authorization: Bearer 方式）：

Terminal window
curl -X POST https://unveilchem.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer cf_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "chemflow_query_compound",
      "arguments": { "compound_name": "Water" }
    }
  }'

成功响应（data: 行内的 JSON）包含分子量、临界参数、沸点等物性数据：

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ... 化合物物性 JSON ... }"
      }
    ],
    "isError": false
  }
}

常见问题

  • 返回 401：Key 缺失或无效，检查认证头格式（详见 认证方式）
  • 返回 429：触发限流，免费层为 1 次/秒、每日 1000 次（详见 配额与限流）
  • 响应是 SSE 格式：服务以 text/event-stream 返回，从 data: 行提取 JSON 即可

下一步