MonkeyType MCP-сервер

Это сервер Model Context Protocol (MCP), который обеспечивает доступ ко всем конечным точкам MonkeyType API . Сервер предоставляет инструменты MCP, которые позволяют моделям больших языков (LLM) взаимодействовать с MonkeyType API.

Функции

• Предоставляет все конечные точки API MonkeyType как инструменты MCP

• Совместимо с любым LLM, поддерживающим Model Context Protocol

• Простая аутентификация на основе API-ключа для каждого вызова инструмента

• Комплексная обработка ошибок

• Осведомленность об ограничении скорости (соблюдает ограничения скорости MonkeyType)

Related MCP server: Strava MCP Server

Установка

Использование 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

Доступные инструменты

Сервер предоставляет следующие конечные точки API MonkeyType в качестве инструментов 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

Инструменты социальной рекламы

• get_psas - Получить социальную рекламу

Цитаты Инструменты

• is_submission_enabled — проверка, включена ли отправка цитат

Инструменты настройки сервера

• get_configuration — Получить конфигурацию сервера

Как получить ключ API MonkeyType (ApeKey)

Чтобы получить собственный ключ API MonkeyType (ApeKey), выполните следующие действия:

1. Войдите в свою учетную запись MonkeyType

2. Нажмите на значок вашего профиля в правом верхнем углу.

3. Выберите «Учетная запись» в раскрывающемся меню.

4. Перейдите на вкладку «Ape Keys»

5. Нажмите «Сгенерировать новый», чтобы создать новый ключ API.

6. Дайте вашему ключу имя (например, «MCP Server»).

7. Выберите соответствующие области в зависимости от того, к каким конечным точкам вам необходимо получить доступ.

8. Нажмите «Сгенерировать»

9. Скопируйте сгенерированный ключ

Важно : храните свой ключ API в безопасности и никогда не делитесь им с другими людьми.

Использование сервера MCP с LLM

Чтобы использовать этот сервер с LLM, вам нужно настроить LLM для использования этого сервера для вызовов инструментов MCP. Вы должны предоставить свой ключ API MonkeyType (ApeKey), установив переменную среды MONKEYTYPE_API_KEY в конфигурации вашего сервера MCP.

Переменные среды

• MONKEYTYPE_API_KEY : (Обязательно) Ваш ключ API MonkeyType. Вы можете получить его в настройках своей учетной записи на monkeytype.com.

• MONKEYTYPE_USERNAME : (Необязательно) Ваше имя пользователя MonkeyType или UID. Это может использоваться определенными инструментами (например, get_profile ) по умолчанию или при использовании определенных ключевых слов.

Пример вызова инструмента

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

Интеграция с платформами LLM

Чтобы интегрировать этот сервер с платформами LLM, такими как OpenAI, Anthropic или другими:

1. Запустите сервер MCP, используя один из методов установки, указанных выше.

2. Настройте платформу LLM для использования этого сервера в качестве поставщика инструментов MCP

3. Передайте stdio сервера в качестве канала связи

Интеграция с IDE

Конфигурация МКП

Чтобы добавить MonkeyType MCP в вашу IDE, добавьте следующее в файл конфигурации MCP вашей IDE:

{
  "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/mcp.json

• Виндсерфинг: ~/.codeium/windsurf/mcp_config.json

• Клайн: ~/.cline/mcp_config.json

• Клод: ~/.claude/mcp_config.json

Интеграция VS-кода

Чтобы использовать этот MCP-сервер в VS Code:

1. Открыть настройки VS Code

2. Поиск "MCP-сервер"

3. Добавьте новый сервер MCP со следующей конфигурацией:

   • Имя: MonkeyType MCP

   • Команда: npx monkeytype-mcp

   • Тип: Стандартный ввод/вывод (stdio)

Доступные инструменты

Сервер предоставляет следующие конечные точки API MonkeyType в качестве инструментов 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

Инструменты социальной рекламы

• get_psas - Получить социальную рекламу

Цитаты Инструменты

• is_submission_enabled — проверка, включена ли отправка цитат

Инструменты настройки сервера

• get_configuration — Получить конфигурацию сервера

Издательский

Если вы вносите изменения на этот сервер и хотите опубликовать свою версию:

npm login
npm publish

Репозиторий GitHub

Этот проект размещен на GitHub по адресу https://github.com/CodeDreamer06/MonkeytypeMCP .

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Благодарности

• MonkeyType за предоставление API

• Модель контекстного протокола (MCP) для архитектуры сервера

Отказ от ответственности

Этот проект официально не связан с MonkeyType. Используйте его на свой страх и риск и убедитесь, что вы соблюдаете условия обслуживания MonkeyType и ограничения скорости API.