Catalysishub MCP Server

🚀 触媒_hub MCP サーバー

このサーバーは、触媒hubのGraphQL APIに直接アクセスすることで、モデルコンテキストプロトコル（MCP）サーバーインターフェースを提供します。触媒研究データへのプログラムによるアクセスを実現し、柔軟なGraphQLクエリをサポートします。

✨ 主な機能

• 直接GraphQLアクセス：有効なGraphQLクエリを実行し、触媒hubのAPIにアクセスできます。
• 包括的なデータアクセス：
  • 触媒反応（方程式、条件、触媒）
  • 材料システム（構造、特性、記述子）
  • 研究出版物（タイトル、DOI、著者）
  • 表面反応データ（吸着エネルギー、結合部位）
• MCP標準互換性：モデルコンテキストプロトコルを実装し、AIエージェントの相互運用性をサポートします。
• 柔軟なクエリサポート：複雑なクエリと変数のパラメータ化をサポートします。
• エラー処理：API接続とクエリ実行に関する強力なエラーレポートを提供します。

🔧 技術詳細

• サーバー設定（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"
    }
  }
  

• 核心依存関係：非同期HTTPリクエストにhttpxを使用します。
• 伝送層：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
   

💻 使用例

基本的な使用法

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スキーマがサーバーと一致していることを確認してください。

• パフォーマンスの問題

  • ページングとフィルタリングを使用してデータ量を制限してください。
  • 大量のデータを一度にリクエストしないでください。

サポートへの問い合わせ

さらなる支援が必要な場合は、以下の方法でお問い合わせください。

• メール：support@catalsishub.com
• 電話：+1 (555) 123-4567

📚 ドキュメント

• GraphQLプロトコル
• MCP規格
• Python非同期プログラミング

以上の内容を参考に、触媒_hub MCPサーバーの機能を全面的に理解して利用することができます。