Claude Typer MCP Extention

克劳德类型

Claude Desktop的Windows MCP扩展，允许Claude直接在任何活动应用程序（谷歌文档、Word、记事本、浏览器等）中键入文本，具有类似人类的打字行为和可配置的写作风格。

特性

• 类人打字 --通过有向图加速、思维停顿、速度漂移和自然方差模拟真实的击键时间
• 审批方式 --在Claude键入文本之前预览文本（默认情况下启用）。批准、拒绝或请求更改
• 可配置速度 --WPM滑块（30-150）和一致性控制
• 剪贴板粘贴 --大块文本的即时粘贴模式
• 键盘快捷键 --向任何应用程序发送格式化命令（Ctrl+B、Ctrl+I等）
• 紧急停止 --如果出现问题，请取消中途键入
• 书写风格预设 --智慧、聪明、简洁、随意、专业等等
• 年级目标 --从一年级到研究生调整输出复杂性
• 样式克隆 --学习你写作风格的校准问卷
• 设置GUI --带有滑块、开关、操作日志和配置文件管理的实时控制面板
• 窗口定位 --通过验证查找并聚焦特定的应用程序窗口
• 健康诊断 --内置健康检查以排除问题
• 操作日志 --所有操作的滚动历史记录以供审查

快速开始

1.安装Python依赖项

cd claude-typer
pip install -r requirements.txt

2.在克劳德桌面注册

将此添加到您的Claude Desktop配置文件中。

标准位置： %APPDATA%\Claude\claude_desktop_config.json

Microsoft应用商店版本： 检查下 %LOCALAPPDATA%\Packages\AnthropicPBC.claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-typer": {
      "command": "python",
      "args": ["C:\\full\\path\\to\\claude-typer\\server.py"]
    }
  }
}

提示： 使用完整的绝对路径 server.py。将JSON中的反斜杠替换为双反斜杠。

3.重新启动克劳德桌面

关闭并重新打开Claude Desktop。您应该看到MCP工具菜单中列出的“Claude Typer”（锤子图标）。设置GUI窗口也将出现。

使用示例

连接后，您可以问Claude以下问题：

• *在我的记事本窗口中键入“Hello，world！”*
• *“聚焦谷歌文档，键入一段关于气候变化的文章”*
• *“将打字速度设置为60 WPM，具有高一致性”*
• *“切换到简明写作预设”*
• *“开始样式校准会话”*
• *“将此代码块粘贴到VS代码中”*
• *按Ctrl+B切换粗体，然后键入“重要”*
• *“关闭审批模式，以便您可以直接键入”*
• *“运行健康检查”*
• *“停止键入”*

MCP工具参考

打字

配置

窗口管理

样式配置文件

诊断

审批模式

默认情况下，Claude Typer在键入任何内容之前都需要您的批准。当你让克劳德输入文本时：

1. Claude生成文本并调用 type_text()
2. 文本是 分阶段的 （尚未键入）并作为预览显示给您
3. 你复习后说“看起来不错”→ 克劳德打电话来 approve_pending() → 开始打字
4. 或者说“改变X”→ 克劳德打电话来 reject_pending() 并再生

您可以通过以下方式关闭此功能 configure_approval(false) 或者通过GUI复选框。

设置GUI

设置窗口会自动与MCP服务器一起启动。它提供：

• WPM滑块 (30–150)
• 一致性滑块 (0.0–1.0)
• 类人模式切换
• 需要批准切换
• 始终在顶部切换
• 样式预设下拉列表
• 等级滑块 (1–16)
• 配置文件选择器
• 状态指示器 包含健康信息
• 活动窗口显示 （每2秒更新一次）
• 可滚动操作日志 带有时间戳

GUI中的更改会立即应用并持久化到 config.json.

类人打字模式

启用后，键入引擎会模拟真实的人类行为：

• 有向图加速度 --常见的字母对（th、er、in等）打字速度更快
• 单词边界暂停 --新单词开头有点犹豫
• 思考停顿 --句子中间偶尔会有较长的停顿
• 句子边界停顿 --句号和问号后自然停顿
• 速度漂移 --WPM随时间逐渐波动±15%
• 对数正态分布 --偶尔有较长的停顿，很少比正常爆发更快

安全特性

• 故障保护：将鼠标移动到屏幕的任何角落，立即中止打字（内置pyautogui）
• 紧急停止：呼叫 stop_typing() 取消中号
• 打字锁：防止并发键入操作发生冲突
• 剪贴板保存：粘贴操作后将恢复原始剪贴板内容

文件结构

claude-typer/
├── server.py              # MCP server entry point
├── typing_engine.py       # Keystroke simulation and timing
├── style_engine.py        # Writing style presets and profiles
├── calibration.py         # Style cloning questionnaire
├── gui.py                 # Settings GUI (tkinter)
├── window_manager.py      # Window detection and focusing
├── config.json            # Persisted settings
├── claude_typer.log       # Log file (created on first run)
├── profiles/              # Custom style profiles
├── requirements.txt       # Python dependencies
└── README.md              # This file

故障排除

跑 health_check() 首先，它将自动识别大多数问题。

Claude Desktop看不到工具：

• 验证中的路径 claude_desktop_config.json 正确并使用双反睫毛
• 确保Python在您的PATH中，或使用完整路径 python.exe
• 完全重新启动Claude Desktop（检查系统托盘）

键入到错误的窗口：

• 使用 check_window("Google Docs") 验证正确的窗口是否聚焦
• 使用 focus_window_by_title() 在键入之前定位正确的应用程序

打字中途停止或行为异常：

• 检查 get_action_log() 有关错误详细信息
• 确保没有其他程序占用键盘焦点
• 故障保护可能已触发——检查鼠标是否靠近屏幕角落

GUI未出现：

• GUI在后台线程中运行；可能需要一点时间才能出现
• 检查 claude_typer.log 用于错误消息
• 确保安装了tkinter（附带标准Python）

Claude Desktop的Microsoft Store版本：

• 配置文件路径与标准安装路径不同
• 查找 %LOCALAPPDATA%\Packages\AnthropicPBC.claude_*\LocalCache\Roaming\Claude\

许可证

麻省理工学院