MCP Cursor Profiles

MCP光标配置文件

一个MCP服务器，与Cursor IDE的原生配置文件系统集成，并添加了自动GitHub身份切换功能。

问题

Cursor将所有配置存储在一组目录中。如果您同时处理多个项目、客户或GitHub身份，则没有内置的方法将Cursor配置文件绑定到特定的GitHub帐户。您最终会手动运行 gh auth switch 每次你改变上下文，或者更糟糕的是，用错误的账户推送到错误的回购。

Gap Analysis

运作原理

此MCP服务器构建 在...之上 Cursor的真实配置文件系统——而不是围绕它：

• 光标配置文件 处理设置、扩展、键绑定、代码段和任务（由Cursor本机管理）
• 身份绑定 将每个配置文件链接到GitHub帐户，因此切换配置文件会自动切换 gh 凭证
• 没有符号链接，没有黑客 --用途 cursor --profile 和光标 storage.json 直接

Architecture Overview

特性

• 列出带有链接GitHub标识的Cursor本地配置文件
• 一步切换配置文件和自动切换GitHub帐户
• 使用可选的GitHub身份绑定创建新配置文件
• 将GitHub标识链接/取消链接到现有配置文件
• 检查并修复每个仓库的git远程身份验证
• 跨平台支持（macOS、Windows、Linux）

先决条件

• Python 3.10或更高版本
• 紫外线 包管理器
• 已安装游标IDE
• 鬼 CLI（git标识功能所需）

安装和配置

克隆存储库并作为工具安装：

git clone https://github.com/aigentic-net/mcp-cursor-profiles.git
cd mcp-cursor-profiles
uv tool install -e .

然后添加到您的MCP客户端配置（Cursor、Claude Desktop等）：

{
  "mcpServers": {
    "cursor-profiles": {
      "command": "cursor-profiles-mcp"
    }
  }
}

uv tool install 地点 cursor-profiles-mcp PATH上的二进制文件（位于 ~/.local/bin/ 默认情况下）。

注： 如果 ~/.local/bin 不在PATH中，请使用完整路径： ``json { "command": "/Users/you/.local/bin/cursor-profiles-mcp" } ` 您可以通过以下方式找到确切的路径 uv tool dir --bin`.

正在更新： 拉取新更改后，重新运行 uv tool install -e . 把它们捡起来。

可用工具

配置文件管理

show_profiles

列出所有Cursor配置文件及其链接的GitHub标识。活动配置文件标有星号(*).

switch_profile

切换到光标配置文件并打开光标。如果配置文件具有链接的GitHub标识 gh 帐户会自动切换。

Profile Switch Workflow

init_profile

使用Cursor的原生配置文件系统创建新的Cursor配置文件。在创建时链接GitHub标识（可选）。

Profile Init Workflow

open_cursor

使用当前配置文件打开Cursor应用程序。

身份管理

link_identity

将GitHub帐户链接到现有的Cursor配置文件。当您切换到此配置文件时 gh 帐户会自动切换。

unlink_identity

从Cursor配置文件中删除GitHub标识链接。

Git身份验证

这些工具通过 gh CLI。

Git Auth Workflow

list_git_accounts

列出通过身份验证的所有GitHub帐户 gh CLI。显示当前处于活动状态的帐户。

check_git_auth

检查是否激活 gh 帐户与存储库的GitHub远程所有者匹配。报告不匹配情况并提出修复建议。

fix_git_remote

将GitHub用户名嵌入到仓库中 origin URL因此 gh 凭据助手会自动解析正确的帐户--无需手动 gh auth switch 需要。

switch_git_account

在中切换活动GitHub帐户 gh CLI。

光标配置文件与身份绑定

身份绑定存储在 ~/.cursor/identities.json --一个简单的JSON文件，将配置文件名映射到GitHub用户名。

平台支持

故障排除

“找不到配置文件”错误

使用确保配置文件存在 show_profiles。配置文件名称区分大小写。

Git推送失败，“权限被拒绝”

跑 check_git_auth 使用repo路径。它会告诉你你的活动之间是否存在不匹配 gh 账户和回购所有者，并提出修复建议。

MCP连接问题

• 确保 uv 已安装并位于您的PATH上
• 重新运行 uv tool install -e . 从项目目录
• 验证二进制文件是否运行： cursor-profiles-mcp （它应该阻止等待输入——这很正常，按Ctrl+C退出）
• 如果找不到命令，请检查 ~/.local/bin 位于您的PATH中，或使用来自的完整路径 uv tool dir --bin

Python版本问题

此软件包需要Python 3.10+。检查您的版本：

python --version

发展

对于服务器本身的工作：

cd mcp-cursor-profiles
uv sync

# Run directly
uv run cursor-profiles-mcp

# Debug mode
MCP_DEBUG=1 uv run cursor-profiles-mcp

对于开发，您可以将MCP配置指向venv：

{
  "mcpServers": {
    "cursor-profiles": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-cursor-profiles", "cursor-profiles-mcp"]
    }
  }
}

许可证

麻省理工学院