Catalysishub MCP Server

🚀 催化_hub MCP 服務器

催化_hub MCP 服務器可直接訪問催化hub的GraphQL API，提供模型上下文協議（MCP）服務器接口。藉助該服務器，用戶能對催化研究數據進行程序化訪問，還可使用靈活的GraphQL查詢。

🚀 快速開始

催化_hub MCP 服務器為用戶提供了便捷的方式來訪問催化研究數據。通過以下步驟，你可以快速開始使用該服務器：

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
   

✨ 主要特性

• 直接GraphQL訪問：可執行任何有效的GraphQL查詢，從而訪問催化hub的API。
• 全面的數據訪問：
  • 催化反應（方程、條件、催化劑）
  • 材料體系（結構、屬性、描述符）
  • 研究出版物（標題、DOI、作者）
  • 表面反應數據（吸附能、結合位點）
• MCP標準兼容性：實現了模型上下文協議，支持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
   

💻 使用示例

基礎用法

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))

高級用法

帶變量的參數化查詢

variables = {
    "materialId": "mp-1234",
    "firstResults": 5
}

response = await hub.catalysishub_graphql(
    query="""query GetMaterialById($materialId: String!, $firstResults: Int!) => Material {
        material(id: $materialId) {
            name
            properties(limit: $firstResults) {
                id
                value
            }
        }
    }""",
    variables=variables
)

查詢優化建議

分頁與過濾

使用skip和limit進行分頁，或添加過濾條件：

{
  reactions(skip: 0, limit: 5, where: {property: "temperature"}) {
    edges {
      node {
        id
        Equation
        Temperature
      }
    }
  }
}

管理大量查詢

對於大規模數據，建議使用batch處理：

from mcp.client import MCPClient

client = MCPClient("catalysishub")
batch_query = client.catalysishub_graphql(
    query=query,
    variables=variables
)
result = await batch_query()

響應結構

成功響應示例：

{
  "data": {
    "reactions": {
      "edges": [
        {
          "node": {
            "id": "123",
            "Equation": "E = mc^2",
            "Temperature": 500
          }
        },
        // 其他節點...
      ]
    }
  }
}

錯誤響應示例：

{
  "errors": [
    {
      "message": "Field 'reactions' not found in type 'Query'",
      "path": ["reactions"],
      "locations": [{ "line": 1, "column": 3 }]
    }
  ]
}

故障排除

常見問題

• 錯誤：未找到字段
  • 檢查查詢中的字段名稱是否正確。
  • 確保使用的GraphQL schema與服務器一致。
• 性能問題
  • 使用分頁和過濾限制數據量。
  • 避免一次性請求大量數據。

聯繫支持

如需進一步幫助，請聯繫：

• 郵件：support@catalsishub.com
• 電話：+1 (555) 123-4567

🔧 技術細節

• 服務器配置（與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"
    }
  }
  

• 核心依賴：使用httpx進行異步HTTP請求。
• 傳輸層：遵循MCP規範的輸入輸出通信。

📚 詳細文檔

• GraphQL協議
• MCP規範
• Python異步編程

通過以上內容，您可以全面瞭解和使用催化_hub MCP 服務器的各項功能。