MonkeyType MCP Server

MonkeyType MCP サーバー

これは、MonkeyType API のすべてのエンドポイントにアクセスできる Model Context Protocol（MCP）サーバーです。このサーバーは、LLM が MonkeyType API を利用できる MCP ツールを提供します。

機能

• MonkeyType API のすべてのエンドポイントを MCP ツールとして提供します
• Model Context Protocol に対応するあらゆる LLM と互換性があります
• ツール呼び出しごとに API キーで簡単に認証できます
• 包括的なエラー処理を備えています
• レート制限を認識します（MonkeyType のレート制限を遵守します）

インストール

npx を使用する（推奨）

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

npx monkeytype-mcp

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

グローバルインストール

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

npm install -g monkeytype-mcp
monkeytype-mcp

手動インストール

リポジトリをクローンする場合は、次の手順に従ってください。

git clone https://github.com/CodeDreamer06/MonkeytypeMCP.git
cd MonkeytypeMCP
npm install
npm start

利用可能なツール

このサーバーは、次の 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. ドロップダウンメニューから「Account」を選択します
4. 「Ape Keys」タブに移動します
5. 「Generate New」をクリックして、新しい API キーを作成します
6. キーに名前を付けます（例：「MCP Server」）
7. アクセスする必要があるエンドポイントに応じて、適切なスコープを選択します
8. 「Generate」をクリックします
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 など）で、デフォルト値として、または特定のキーワードが使用された場合に利用できます。

ツール呼び出しの例

{
  "name": "get_configuration",
  "arguments": {}
}

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

このサーバーを OpenAI、Anthropic などの LLM プラットフォームと統合するには、次の手順に従ってください。

1. 上記のいずれかのインストール方法を使用して MCP サーバーを起動します
2. このサーバーを MCP ツールプロバイダーとして使用するよう、LLM プラットフォームを設定します
3. サーバーの stdio を通信チャネルとして渡します

IDE との統合

MCP の設定

MonkeyType MCP を IDE に追加するには、IDE の MCP 設定ファイルに次の内容を追加します。

{
  "mcpServers": {
    "monkeytype": {
      "command": "sh",
      "args": ["-c", "cd $(mktemp -d) && npm install monkeytype-mcp && npx monkeytype-mcp"],
      "env": {
        "MONKEYTYPE_API_KEY": "YOUR_APE_KEY_HERE"
      }
    }
  }
}

設定ファイルの場所：

• Cursor：~/.cursor/mcp.json
• Windsurf：~/.codeium/windsurf/mcp_config.json
• Cline：~/.cline/mcp_config.json
• Claude：~/.claude/mcp_config.json

VS Code との統合

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

1. VS Code の設定を開きます
2. 「MCP Server」を検索します
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（string、任意）：プロフィールを取得するユーザーの 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 - サーバー設定を取得します

公開

このサーバーに変更を加えて独自のバージョンを公開する場合：

npm login
npm publish

GitHub リポジトリ

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

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• API を提供している MonkeyType に感謝します
• サーバーアーキテクチャを提供している Model Context Protocol (MCP) に感謝します

免責事項

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