Practera MCP Server

Practera MCP サーバー

Practera の GraphQL API へのアクセスを提供し、AI モデルが Practera 学習データを照会できるようにする MCP (Model Context Protocol) サーバー。

Practera MCP を選ぶ理由

このMCPサーバーでは、LLMを使用してPracteraのプロジェクトと評価を分析できます。現時点では、これは学習デザイナー（作成者ユーザー）のみが利用できます。

この MCP サーバーの使用方法の例をいくつか示します。

• プロジェクトの構造を分析し、どのように拡張、圧縮できるかを検討します。
• 異なる学年や異なる対象者に合わせてプロジェクトを再構成します。
• プロジェクトの評価を評価し、改善方法を検討します。
• プロジェクトの青写真とテンプレートを生成します。
• 評価と質問を生成する
• プロジェクトの共通カートリッジ バージョンを作成するか、他の LMS データ ファイルからプロジェクトをインポートします。

ロードマップ

[ ] LLMレポートを生成するためのメトリクスAPIをサポート [ ] 安全なアクセスのためのOAuth 2.1をサポート [ ] 評価、マイルストーン、アクティビティ、タスクの動的な作成をサポート [ ] メディアアセットの生成をサポート [ ] プロジェクトのコンテキストに基づいた動的なリソース/ツール/プロンプトの選択

特徴

• MCP の Server-Sent Events (SSE) トランスポート
• AWS Lambda デプロイメントサポート
• Practera API との GraphQL 統合
• 地域固有のエンドポイント
• APIキー認証
• 安全なアクセスのためのOAuth 2.1サポート

前提条件

• Node.js 18歳以上
• npm
• AWS アカウント（デプロイ用）
• Practera APIキー
• OAuth クライアント資格情報 (OAuth 認証用)

インストール

1. このリポジトリをクローンする
2. 依存関係をインストールします:
   npm install

地域開発

1. 開発モードでサーバーを起動します。
   npm run dev
2. サーバーはhttp://localhost:3000/sseで利用できます。
3. OAuthエンドポイントはhttp://localhost:3000/oauth/*からアクセスできます。

建てる

デプロイメント用にプロジェクトをビルドするには:

AWS Lambdaへのデプロイ

1. AWS CLIがインストールされ、設定されていることを確認してください。
2. OAuth 構成パラメータを設定します。
   export PRACTERA_CLIENT_ID=your_client_id export REDIRECT_URI=your_redirect_uri export ISSUER_URL=your_issuer_url export BASE_URL=your_base_url
3. Serverless Framework を使用してデプロイします。
   npm run deploy -- --param="practeraClientId=$PRACTERA_CLIENT_ID" --param="redirectUri=$REDIRECT_URI" --param="issuerUrl=$ISSUER_URL" --param="baseUrl=$BASE_URL"

認証方法

APIキー認証

シンプルな統合のために、以下を提供することで API キー認証を使用できます。

• 各ツール呼び出しのapikeyパラメータ
• Practera地域を指定するためのregionパラメータ

OAuth 2.1 認証（近日公開予定）

サーバーは、安全な認証フローのために OAuth 2.1 もサポートしています。

1. 認証のためにユーザーを/oauth/authorizeにリダイレクトする
2. /oauth/tokenで認証コードをアクセストークンと交換します。
3. ベアラートークンを使用してMCPサーバーのエンドポイントにアクセスする
4. 必要に応じて/oauth/revokeでトークンを取り消します

利用可能なMCPツール

このサーバーは次の MCP ツールを公開します。

• mcp_practera_get_project - Practera プロジェクトの詳細を取得する
• mcp_practera_get_assessment - Practera 評価の詳細を取得する

MCP クライアント構成

MCP クライアントからこの MCP サーバーに接続する場合は、次の情報を提供する必要があります。

1. Practera 認証用の API キー (API キー認証を使用している場合)
2. Practera API のリージョン (米国、オーストラリア、EUK、または p2-stage)
3. OAuth 構成 (OAuth 認証を使用する場合)

クロードデスクトップの構成例

使用例（クロード氏と）

Claude に、MCP ツールを使用して Practera データを操作するよう依頼できます。

次に、Claude はmcp_practera_get_projectツールを使用して、構成から API キーとリージョンを提供します。

ライセンス

MITライセンス