MonkeyType MCP-сервер

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

Функции

Предоставляет все конечные точки API MonkeyType как инструменты MCP
Совместимо с любым LLM, поддерживающим Model Context Protocol
Простая аутентификация на основе 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

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

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

Войдите в свою учетную запись MonkeyType
Нажмите на значок вашего профиля в правом верхнем углу.
Выберите «Учетная запись» в раскрывающемся меню.
Перейдите на вкладку «Ape Keys»
Нажмите «Сгенерировать новый», чтобы создать новый ключ API.
Дайте вашему ключу имя (например, «MCP Server»).
Выберите соответствующие области в зависимости от того, к каким конечным точкам вам необходимо получить доступ.
Нажмите «Сгенерировать»
Скопируйте сгенерированный ключ

Важно : храните свой ключ 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 или другими:

Запустите сервер MCP, используя один из методов установки, указанных выше.
Настройте платформу LLM для использования этого сервера в качестве поставщика инструментов MCP
Передайте 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:

Открыть настройки VS Code
Поиск "MCP-сервер"
Добавьте новый сервер 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.

Integrations