关键词

ChatGPTmacOSAppleScript自动化文本交互

项目简介

本项目 'mcp-server-chatgpt-app' 是一个 MCP 服务器的实现，它允许你通过 MCP 客户端（如 Cursor 或 Chatwise）与安装在 macOS 上的 ChatGPT 桌面应用程序进行交互。它通过 AppleScript 自动化操作 ChatGPT 应用，实现向 ChatGPT 发送 prompt 并获取响应的功能。

请注意： 使用此 MCP 服务器需要预先安装 ChatGPT macOS 客户端，并授予必要的辅助功能和自动化权限。

主要功能点

  • 连接 ChatGPT macOS 应用： 通过 AppleScript 控制本地 ChatGPT 应用程序。
  • 'ask_chatgpt' 工具： 提供一个名为 'ask_chatgpt' 的工具，允许 MCP 客户端向 ChatGPT 发送文本 prompt。
  • 文本交互： 接收 MCP 客户端发送的文本 prompt，将其输入到 ChatGPT 应用，并模拟键盘操作发送消息。
  • 错误处理与提示： 当权限不足时，能够检测到错误并提供清晰的帮助信息，指导用户授权。

安装步骤

  1. 安装 ChatGPT macOS 应用程序： 如果尚未安装，请从 ChatGPT macOS app 下载并安装 ChatGPT macOS 桌面应用程序。
  2. 安装 uv： 根据 uv 官方文档指引安装 'uv' 工具。 'uv' 是一个快速的 Python 包安装和运行工具，本项目使用 'uvx' 命令来运行 MCP 服务器。

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下分别以 Cursor 和 Chatwise 为例，提供配置方法。

Cursor 配置：

在 Cursor 编辑器的 '.mcp.json' 文件中，添加如下 'mcpServers' 配置：

{
  "mcpServers": {
    "chatgpt": {
      "command": "uvx",
      "args": ["mcp-server-chatgpt-app"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
  • server name (chatgpt): 服务器名称，在 Cursor 中用于标识和选择该 MCP 服务器。
  • command (uvx): 启动服务器的命令，这里使用 'uvx' 运行 Python 脚本。
  • args (["mcp-server-chatgpt-app"]): 传递给 'uvx' 命令的参数，指定要运行的脚本为 'mcp-server-chatgpt-app'（实际会运行 'src/mcp_server_chatgpt/server.py'）。
  • env ({}): 环境变量，此处为空。
  • disabled (false): 服务器是否禁用，设置为 'false' 表示启用。
  • autoApprove ([]): 自动批准的权限请求，此处为空。

Chatwise 配置：

在 Chatwise 应用中，进入 "Settings" -> "Tools" -> "Add"，然后使用以下配置：

  • Type: 'stdio' (标准输入输出流)
  • ID: 'ChatGPT' (工具 ID，用于在 Chatwise 中标识)
  • Command: 'uvx mcp-server-chatgpt-app' (启动服务器的命令，与 Cursor 配置中的 'command' 和 'args' 组合一致)

基本使用方法

  1. 授权权限： 首次运行前，需要授予 MCP 客户端（例如 Cursor 或 Chatwise）辅助功能和自动化权限，以便其控制 ChatGPT 和系统事件。根据 README.md 的 "Required Permissions" 部分的指引进行授权。
  2. 启动 MCP 客户端和服务器： 启动配置好的 MCP 客户端（如 Cursor 或 Chatwise），客户端会自动尝试连接配置的 MCP 服务器。
  3. 使用 'ask_chatgpt' 工具： 在 MCP 客户端中，可以使用 'ask_chatgpt' 工具向 ChatGPT 发送 prompt。具体的调用方式取决于 MCP 客户端的实现，通常可以通过特定的语法或界面来调用工具。例如，在 Cursor 中，你可能可以使用 '@chatgpt ask_chatgpt' 这样的语法，然后在后续输入框中输入你的 prompt。

本地开发和运行：

如果你需要本地开发或直接运行服务器，可以使用以下命令：

uv --directory $HOME/Developer/mcp-server-chatgpt-app/src/mcp_server_chatgpt run server.py

请将 '$HOME/Developer/mcp-server-chatgpt-app/src/mcp_server_chatgpt' 替换为你的本地仓库 'src/mcp_server_chatgpt' 目录的实际路径。

信息

分类

桌面与硬件

访问项目