MonkeyType MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供对MonkeyType API所有端点的访问。该服务器公开了允许大型语言模型 (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 服务器”）

7. 根据需要访问的端点选择适当的范围

8. 点击“生成”

9. 复制生成的密钥

重要提示：请确保您的 API 密钥安全，切勿公开分享。

使用 MCP 服务器和 LLM

要将此服务器与 LLM 一起使用，您需要配置 LLM 以使用此服务器进行 MCP 工具调用。您必须通过在 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. 配置您的 LLM 平台以使用此服务器作为 MCP 工具提供程序

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 Code 集成

要在 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 文件。

致谢

• MonkeyType用于提供 API

• 用于服务器架构的模型上下文协议 (MCP)

免责声明

本项目与 MonkeyType 无正式关联。使用时请自行承担风险，并确保遵守 MonkeyType 的服务条款和 API 速率限制。