catalysishub-mcp-server

catalysishub-mcp-server 是一个 MCP（Model Context Protocol）服务器，作为 Catalysis Hub GraphQL API 的接口，通过编程方式访问催化研究数据。它允许 AI 代理以标准化的 MCP 协议与 Catalysis Hub 数据库交互。

用途

该工具旨在为 AI 代理提供对 Catalysis Hub 数据库中催化研究数据的程序化访问，支持执行任意有效的 GraphQL 查询。

主要能力

• 直接 GraphQL 访问：可对 Catalysis Hub API 执行任何有效的 GraphQL 查询。
• 全面的数据访问：涵盖催化反应（方程式、条件、催化剂）、材料系统（结构、性质、描述符）、研究出版物（标题、DOI、作者）和表面反应数据（吸附能、结合位点）。
• MCP 标准合规：实现 Model Context Protocol，支持 AI 代理互操作性。
• 灵活查询支持：支持带变量参数化的复杂查询。
• 错误处理：针对 API 连接和查询执行提供健壮的错误报告。

使用方式

安装

1. 克隆仓库：

   git clone <repository_url>
   cd catalysishub-mcp-server
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 验证安装：

   python3 catalysishub_mcp_server.py --version
   # 应输出：catalysishub-mcp-server 0.1.0
   

服务器配置（匹配 claude_desktop_config.json）

{
  "command": "/Users/quentincody/.env/bin/python3",
  "args": ["/Users/quentincody/catalysishub-mcp-server/catalysishub_mcp_server.py"],
  "options": {
    "cwd": "/Users/quentincody/catalysishub-mcp-server"
  }
}

查询示例

• 基本查询执行
• 带变量的参数化查询
• 查询优化提示：使用 GraphQL 片段、批量相关查询。

适用场景

适用于需要程序化访问催化研究数据的学术或研究场景，例如通过 AI 代理检索催化反应、材料性质、出版物和表面反应数据。

限制

• 该项目为非官方接口，依赖 Catalysis Hub 的 GraphQL API。
• 学术用途需按 CITATION.md 提供引用；商业/非学术用途遵循标准 MIT 许可证条款。
• 核心依赖 httpx 用于异步 HTTP 请求；传输采用标准输入/输出通信。
• 常见问题包括 HTTP 请求错误（需检查网络连接）、JSON 解码错误（需检查查询语法）、超时错误（可为复杂查询添加超时参数）。