MonkeyType MCP Server

MonkeyType MCP 服务

这是一个模型上下文协议（MCP）服务，可访问 MonkeyType API 的所有端点。该服务提供 MCP 工具，让大语言模型（LLM）能够与 MonkeyType API 交互。

功能

• 将所有 MonkeyType API 端点作为 MCP 工具提供
• 兼容所有支持模型上下文协议的 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 密钥，切勿公开分享。

将 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）可将其用作默认值，或在使用特定关键词时使用。

工具调用示例

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

与 LLM 平台集成

要将此服务与 OpenAI、Anthropic 等 LLM 平台集成：

1. 使用上述任一安装方式启动 MCP 服务
2. 将 LLM 平台配置为使用此服务作为 MCP 工具提供方
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 集成

要在 VS Code 中使用此 MCP 服务：

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

致谢

• MonkeyType 提供 API
• Model Context Protocol (MCP) 提供服务架构

免责声明

此项目与 MonkeyType 没有官方关联。使用风险由你自行承担，并请确保遵守 MonkeyType 的服务条款和 API 速率限制。