Integrations
Integrates with Codeium's Windsurf through MCP configuration at ~/.codeium/windsurf/mcp_config.json, enabling MonkeyType API access.
Project is hosted on GitHub with repository information provided for accessing source code and contributing.
Provides access to all MonkeyType API endpoints, allowing interaction with user data, test results, leaderboards, and server configuration. Features include retrieving personal bests, user stats, test results, leaderboard data, and checking username availability.
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),请按照以下步骤操作:
- 登录您的MonkeyType帐户
- 点击右上角的个人资料图标
- 从下拉菜单中选择“帐户”
- 导航至“Ape Keys”选项卡
- 点击“生成新”来创建新的 API 密钥
- 给你的密钥命名(例如,“MCP 服务器”)
- 根据需要访问的端点选择适当的范围
- 点击“生成”
- 复制生成的密钥
重要提示:请确保您的 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 平台集成:
- 使用上述安装方法之一启动 MCP 服务器
- 配置您的 LLM 平台以使用此服务器作为 MCP 工具提供程序
- 通过服务器的 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 服务器:
- 打开 VS Code 设置
- 搜索“MCP 服务器”
- 添加一个新的 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 速率限制。
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
模型上下文协议服务器使 LLM 能够与所有 MonkeyType API 端点交互,从而通过自然语言提供对类型测试数据、用户配置文件、排行榜和统计数据的访问。
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol Server that enables LLMs to interact with and execute REST API calls through natural language prompts, supporting GET/PUT/POST/PATCH operations on configured APIs.Last updated -5PythonApache 2.0
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.Last updated -TypeScriptMIT License
- -security-license-qualityA Python implementation of the Model Context Protocol that allows applications to provide standardized context for LLMs, enabling creation of servers that expose data and functionality to LLM applications through resources, tools, and prompts.Last updated -PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to interact with web pages, take screenshots, generate test code, scrape web pages, and execute JavaScript in a real browser environment.Last updated -29101TypeScriptMIT License