MonkeyType MCP サーバー

これは、MonkeyType APIのすべてのエンドポイントへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、大規模言語モデル（LLM）がMonkeyType API と対話できるようにするMCPツールを公開しています。

特徴

• すべてのMonkeyType APIエンドポイントをMCPツールとして公開します

• モデルコンテキストプロトコルをサポートするすべてのLLMと互換性があります

• ツール呼び出しごとにシンプルな API キーベースの認証

• 包括的なエラー処理

• レート制限の認識（MonkeyType のレート制限を尊重）

インストール

npx の使用 (推奨)

サーバーを実行する最も簡単な方法は npx を使用することです。

これにより、サーバーの最新バージョンが直接ダウンロードされ、実行されます。

グローバルインストール

パッケージをグローバルにインストールすることもできます。

手動インストール

リポジトリのクローンを作成する場合:

利用可能なツール

サーバーは、次の MonkeyType API エンドポイントを MCP ツールとして公開します。

ユーザーツール

• check_username - ユーザー名が使用可能かどうかを確認する

• get_personal_bests - ユーザーの個人ベストを取得する

• get_tags - ユーザーのタグを取得する

• get_stats - ユーザーの統計情報を取得する

• get_profile - ユーザーのプロフィールを取得する

• send_forgot_password_email - パスワードを忘れた場合のメールを送信する

• get_current_test_activity - 現在のテストアクティビティを取得する

• get_streak - ユーザーの連続記録を取得する

テスト結果ツール

• get_results - 最大1000件のテスト結果を取得します

• get_result_by_id - IDで結果を取得する

• get_last_result - 最後の結果を取得する

パブリックツール

• get_speed_histogram - 速度ヒストグラムを取得する

• get_typing_stats - タイピング統計を取得する

リーダーボードツール

• get_leaderboard - リーダーボードを取得する

• get_leaderboard_rank - リーダーボードの順位を取得する

• get_daily_leaderboard - 毎日のリーダーボードを取得する

• get_weekly_xp_leaderboard - 週次 XP リーダーボードを取得する

PSAツール

• get_psas - PSA を取得する

引用ツール

• is_submission_enabled - 見積りの送信が有効になっているかどうかを確認します

サーバー構成ツール

• get_configuration - サーバー構成を取得する

MonkeyType APIキー（ApeKey）を取得する方法

独自の MonkeyType API キー (ApeKey) を取得するには、次の手順に従います。

1. MonkeyTypeアカウントにサインイン

2. 右上のプロフィールアイコンをクリックします

3. ドロップダウンメニューから「アカウント」を選択します

4. 「Ape Keys」タブに移動します

5. 「新規生成」をクリックして新しいAPIキーを作成します

6. キーに名前を付けます（例：「MCP Server」）

7. アクセスする必要があるエンドポイントに基づいて適切なスコープを選択します

8. 「生成」をクリック

9. 生成されたキーをコピーする

重要: API キーを安全に保管し、公開しないでください。

LLM で MCP サーバーを使用する

このサーバーをLLMで使用するには、MCPツールの呼び出しにこのサーバーを使用するようにLLMを設定する必要があります。MCPサーバー設定でMONKEYTYPE_API_KEY環境変数を設定し、MonkeyType APIキー（ApeKey）を指定する必要があります。

環境変数

• MONKEYTYPE_API_KEY : (必須) MonkeyType APIキー。monkeytype.comのアカウント設定から取得できます。

• MONKEYTYPE_USERNAME : (オプション) MonkeyType のユーザー名または UID。これは、特定のツール ( get_profileなど) でデフォルトとして使用したり、特定のキーワードが使用されるときに使用したりできます。

ツール呼び出しの例

LLMプラットフォームとの統合

このサーバーを OpenAI、Anthropic などの LLM プラットフォームと統合するには:

1. 上記のインストール方法のいずれかを使用してMCPサーバーを起動します。

2. このサーバーをMCPツールプロバイダーとして使用するようにLLMプラットフォームを構成します

3. サーバーのstdioを通信チャネルとして渡す

IDE統合

MCP構成

MonkeyType MCP を IDE に追加するには、IDE の MCP 構成ファイルに以下を追加します。

設定ファイルの場所:

• カーソル: ~/.cursor/mcp.json

• ウィンドサーフィン: ~/.codeium/windsurf/mcp_config.json

• クライン: ~/.cline/mcp_config.json

• クロード: ~/.claude/mcp_config.json

VSコード統合

VS Code でこの MCP サーバーを使用するには:

1. VS Codeの設定を開く

2. 「MCPサーバー」を検索

3. 次の構成で新しい MCP サーバーを追加します。

   • 名前: MonkeyType MCP

   • コマンド: npx monkeytype-mcp

   • タイプ: 標準入出力 (stdio)

利用可能なツール

サーバーは、次の MonkeyType API エンドポイントを MCP ツールとして公開します。

ユーザーツール

• check_username - ユーザー名が使用可能かどうかを確認する

• get_personal_bests - ユーザーの個人ベストを取得する

• get_tags - ユーザーのタグを取得する

• get_stats - ユーザーの統計情報を取得する

• get_profile - ユーザーのプロフィールを取得する

• send_forgot_password_email - パスワードを忘れた場合のメールを送信する

• get_current_test_activity - 現在のテストアクティビティを取得する

• get_streak - ユーザーの連続記録を取得する

get_profile

ユーザーの公開プロフィールを取得します。

パラメータ:

• uidOrName (文字列、オプション): プロファイルを取得するユーザーの UID またはユーザー名。

  • 特定のユーザー名または UID を指定すると、そのユーザーのプロファイルが取得されます。

  • 「me」、「self」、「current」、「my」などのキーワードを使用できます。これらのキーワードのいずれかが使用されると、ツールはMONKEYTYPE_USERNAME環境変数（設定されている場合）を使用します。

  • このパラメータを完全に省略すると、ツールはMONKEYTYPE_USERNAME環境変数 (設定されている場合) も使用しようとします。

  • uidOrNameパラメータが省略され（またはキーワードが使用され）、 MONKEYTYPE_USERNAME環境変数が設定されていない場合は、エラーが発生します。

テスト結果ツール

• get_results - 最大1000件のテスト結果を取得します

• get_result_by_id - IDで結果を取得する

• get_last_result - 最後の結果を取得する

パブリックツール

• get_speed_histogram - 速度ヒストグラムを取得する

• get_typing_stats - タイピング統計を取得する

リーダーボードツール

• get_leaderboard - リーダーボードを取得する

• get_leaderboard_rank - リーダーボードの順位を取得する

• get_daily_leaderboard - 毎日のリーダーボードを取得する

• get_weekly_xp_leaderboard - 週次 XP リーダーボードを取得する

PSAツール

• get_psas - PSA を取得する

引用ツール

• is_submission_enabled - 見積りの送信が有効になっているかどうかを確認します

サーバー構成ツール

• get_configuration - サーバー構成を取得する

出版

このサーバーに変更を加えて独自のバージョンを公開したい場合は、次の手順に従います。

GitHubリポジトリ

このプロジェクトは、GitHub のhttps://github.com/CodeDreamer06/MonkeytypeMCPでホストされています。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• APIを提供してくれたMonkeyType

• サーバーアーキテクチャのモデルコンテキストプロトコル（MCP）

免責事項

このプロジェクトはMonkeyTypeと公式に提携していません。ご利用の際は自己責任でお願いいたします。MonkeyTypeの利用規約およびAPIレート制限を遵守してください。