Hasura GraphQL

🚀 高度な機能

高度な機能を持つこのサーバーに関する詳細なガイドです。以下の手順に従って、サーバーのセットアップ、実行、および高度な設定を行うことができます。

🚀 クイックスタート

📦 インストール

プロジェクトに必要な依存関係をインストールするには、以下のコマンドを実行します。

pnpm install

🏗️ サービスのビルド

TypeScript コードを dist ディレクトリにビルドします。

pnpm run build

🚀 サーバーの起動

以下のコマンドを使用して、サーバーを起動し、Hasura GraphQL エンドポイントとオプションの管理者キーを指定します。

# pnpm スクリプトを使用して実行
pnpm start <HASURA_GRAPHQL_ENDPOINT> [ADMIN_SECRET]

# または直接 Node.js を使用
node dist/index.js <HASURA_GRAPHQL_ENDPOINT> [ADMIN_SECRET]

例:

pnpm start https://my-hasura.cloud/v1/graphql mysecretkey123

または

node dist/index.js https://my-hasura.cloud/v1/graphql mysecretkey123

管理者キーが不要な場合（デフォルトのロール権限を使用）：

pnpm start https://my-hasura.cloud/v1/graphql

サーバーが起動すると、初期スキーマの逆コンパイルを試み、STDIO トランスポートに接続し、状態メッセージを stderr に記録します。stdin で MCP JSON-RPC リクエストを待ち受け、stdout に応答を送信します。

💻 使用例

基本的な使用法

MCP クライアント（Cursor、Claude Desktop など）をこのサーバーに接続するには、以下の手順に従います。

1. 絶対パスを見つける

   • Node 実行ファイル：ターミナルで which node を実行します。
   • サーバースクリプト：mcp-hasura-advanced ディレクトリに移動し、pwd を実行します。結果に /dist/index.js を追加します。
   • プロジェクトディレクトリ：pwd の出力結果です。

2. クライアントを設定する クライアントの設定ファイル（Cursor の settings.json、Claude Desktop の claude_desktop_config.json など）を開きます。

3. サーバーエントリを追加する 適切なキーの下にエントリを追加します（Cursor の cursor.customMcpServers 配列、Claude Desktop の mcpServers オブジェクトなど）。

Cursor settings.json の例:

{
  // ... 他の設定 ...
  "cursor.customMcpServers": [
    // ... 他のサーバー ...
    {
      "name": "My Advanced Hasura Server", // Cursor UI に表示される名前
      "command": "/path/to/your/node", // <<< 'which node' の絶対パス
      "args": [
        "/absolute/path/to/mcp-hasura-advanced/dist/index.js", // <<< コンパイル後のスクリプトの絶対パス
        "https://YOUR_HASURA_ENDPOINT.com/v1/graphql",      // <<< あなたのエンドポイント
        "YOUR_ADMIN_SECRET"                                   // <<< あなたのシークレット（シークレットが不要な場合は削除）
      ],
      // モジュール解決の一貫性を保つために推奨されますが、オプションです。
      "cwd": "/absolute/path/to/mcp-hasura-advanced" // <<< プロジェクトルートディレクトリの絶対パス
    }
  ]
}

Claude Desktop claude_desktop_config.json の例:

{
    "mcpServers": {
        // ... 他のサーバー ...
        "hasura-advanced": { // Claude 内部で使用されるキーワード
            "command": "/path/to/your/node",
            "args": [
                "/absolute/path/to/mcp-hasura-advanced/dist/index.js",
                "https://YOUR_HASURA_ENDPOINT.com/v1/graphql",
                "YOUR_ADMIN_SECRET"
            ],
            // モジュール解決の一貫性を保つために推奨されますが、オプションです。
            "cwd": "/absolute/path/to/mcp-hasura-advanced"
        }
    }
}

高度な使用法

環境変数の設定

package.json でカスタム環境変数を追加することができます。

{
  "env": {
    "NODE_ENV": "production",
    "MY_SECRET": "my-secret-value"
  }
}

異なるポートの使用

デフォルトのポート（3000）を変更するには、実行時に指定します。

pnpm start --port=3001 <HASURA_GRAPHQL_ENDPOINT> [ADMIN_SECRET]

設定の検証

サーバーを起動する前に、すべての設定が正しいことを検証します。

pnpm run lint

🛠️ 問題解決

問題が発生した場合は、以下の点を確認してください。

• Hasura エンドポイントが有効な URL であることを確認します。
• 管理者キーが正しく設定されていることを確認します。
• コンソール出力を確認して、エラーメッセージを取得します。

📚 詳細ドキュメント

コマンドラインオプション

pnpm start [options] <HASURA_GRAPHQL_ENDPOINT> [ADMIN_SECRET]
オプション:
  --port=VALUE          カスタムサーバーポート (デフォルト: 3000)
  --verbose             詳細なログ記録を有効にする

サンプルプロジェクト構造

mcp-hasura-advanced/
├── dist/              # コンパイル後の出力ディレクトリ
├── src/
│   ├── index.ts      # メインアプリケーションファイル
│   └── schema.ts     # GraphQL スキーマ定義
└── package.json       # 依存関係とスクリプトの設定

コントリビューションガイド

このプロジェクトに貢献するには、リポジトリをフォークし、dev ブランチで変更を加えてください。コミットする前に、すべてのテストを通過していることを確認してください。

📄 ライセンス

[ここにライセンス情報を挿入]