Catalysis Hub MCP Server

Catalysis Hub MCP Server

site icon
2025.04.08 1
Python数据访问研究工具其它
Catalysis Hub MCP Server 是一个基于 Model Context Protocol (MCP) 的服务接口,用于访问 Catalysis Hub 的 GraphQL API,提供对催化研究数据的程序化访问。该服务支持灵活的 GraphQL 查询,适用于需要访问催化反应、材料系统、研究出版物和表面反应数据的场景。
View on GitHub

Overview

基本能力

产品定位

Catalysis Hub MCP Server 是一个用于访问 Catalysis Hub GraphQL API 的 MCP 服务接口,旨在为研究人员和开发者提供程序化访问催化研究数据的能力。

核心功能

  • 直接 GraphQL 访问:支持执行任何有效的 GraphQL 查询
  • 全面的数据访问
  • 催化反应(方程式、条件、催化剂)
  • 材料系统(结构、属性、描述符)
  • 研究出版物(标题、DOI、作者)
  • 表面反应数据(吸附能、结合位点)
  • MCP 标准兼容:实现 Model Context Protocol,支持 AI 代理互操作性
  • 灵活的查询支持:支持带变量参数化的复杂查询
  • 错误处理:提供强大的错误报告功能

适用场景

  • 催化研究数据分析
  • 材料科学研究
  • 学术研究数据集成
  • AI 代理数据访问

工具列表

  • httpx:用于异步 HTTP 请求的核心依赖

常见问题解答

  • HTTP 请求错误:检查与 api.catalysis-hub.org 的网络连接
  • JSON 解码错误:使用 Catalysis Hub 的 GraphQL Playground 检查查询语法
  • 超时错误:为复杂查询添加 timeout 参数

使用教程

使用依赖

  1. 确保已安装 Python 3 和 pip

安装教程

  1. 克隆仓库bash git clone <repository_url> cd catalysishub-mcp-server

  2. 安装依赖bash pip install -r requirements.txt

  3. 验证安装bash python3 catalysishub_mcp_server.py --version # 应输出:catalysishub-mcp-server 0.1.0

调试方式

  1. 运行服务: bash python3 catalysishub_mcp_server.py

  2. 使用 MCP 客户端测试查询: ```python from mcp.client import MCPClient

async with MCPClient("catalysishub") as hub: result = await hub.catalysishub_graphql( query="""{ reactions(first: 5) { edges { node { id Equation Temperature } } } }""" ) print(json.loads(result)) ```

许可证

该项目遵循 MIT 开源许可条款。