MCP光标配置文件
一个MCP服务器，与Cursor IDE的原生配置文件系统集成，并添加了自动GitHub身份切换功能。
问题
Cursor将所有配置存储在一组目录中。如果您同时处理多个项目、客户或GitHub身份，则没有内置的方法将Cursor配置文件绑定到特定的GitHub帐户。您最终会手动运行 gh auth switch 每次你改变上下文，或者更糟糕的是，用错误的账户推送到错误的回购。
运作原理
此MCP服务器构建 在...之上 Cursor的真实配置文件系统——而不是围绕它：
- 光标配置文件 处理设置、扩展、键绑定、代码段和任务（由Cursor本机管理）
- 身份绑定 将每个配置文件链接到GitHub帐户，因此切换配置文件会自动切换
gh凭证 - 没有符号链接，没有黑客 --用途
cursor --profile和光标storage.json直接
特性
- 列出带有链接GitHub标识的Cursor本地配置文件
- 一步切换配置文件和自动切换GitHub帐户
- 使用可选的GitHub身份绑定创建新配置文件
- 将GitHub标识链接/取消链接到现有配置文件
- 检查并修复每个仓库的git远程身份验证
- 跨平台支持（macOS、Windows、Linux）
先决条件
安装和配置
克隆存储库并作为工具安装：
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_name | string | 要切换到的配置文件的名称 |
init_profile
使用Cursor的原生配置文件系统创建新的Cursor配置文件。在创建时链接GitHub标识（可选）。
| 参数 | 类型 | 说明 |
|---|---|---|
profile_name | string | 新配置文件的名称 |
github_username | string | 要链接的GitHub用户名（可选） |
open_cursor
使用当前配置文件打开Cursor应用程序。
身份管理
link_identity
将GitHub帐户链接到现有的Cursor配置文件。当您切换到此配置文件时 gh 帐户会自动切换。
| 参数 | 类型 | 说明 |
|---|---|---|
profile_name | string | 游标配置文件的名称 |
github_username | string | 要链接的GitHub用户名 |
unlink_identity
从Cursor配置文件中删除GitHub标识链接。
| 参数 | 类型 | 说明 |
|---|---|---|
profile_name | string | 要取消链接的游标配置文件的名称 |
Git身份验证
这些工具通过 gh CLI。
list_git_accounts
列出通过身份验证的所有GitHub帐户 gh CLI。显示当前处于活动状态的帐户。
check_git_auth
检查是否激活 gh 帐户与存储库的GitHub远程所有者匹配。报告不匹配情况并提出修复建议。
| 参数 | 类型 | 说明 |
|---|---|---|
repo_path | string | git存储库的绝对路径 |
fix_git_remote
将GitHub用户名嵌入到仓库中 origin URL因此 gh 凭据助手会自动解析正确的帐户--无需手动 gh auth switch 需要。
| 参数 | 类型 | 说明 |
|---|---|---|
repo_path | string | git存储库的绝对路径 |
username | string | 要嵌入的GitHub用户名（默认为仓库所有者） |
switch_git_account
在中切换活动GitHub帐户 gh CLI。
| 参数 | 类型 | 说明 |
|---|---|---|
account | string | 要切换到的GitHub用户名 |
光标配置文件与身份绑定
| 功能 | 光标配置文件（本机） | 标识绑定（此工具） |
|---|---|---|
| 设置隔离 | 是 | -- |
| 扩展隔离 | 是 | -- |
| 每个配置文件的密钥绑定 | 是 | -- |
| 每个配置文件的片段 | 是 | -- |
| Git凭据切换 | 否 | 是 |
汽车 gh auth switch | 否 | 是 |
| 每回购授权验证 | 否 | 是 |
| 在光标设置UI中可见 | 是 | -- |
身份绑定存储在 ~/.cursor/identities.json --一个简单的JSON文件，将配置文件名映射到GitHub用户名。
平台支持
| 平台 | 游标配置路径 |
|---|---|
| macOS | ~/Library/Application Support/Cursor |
| 窗户 | %APPDATA%/Cursor |
| Linux | ~/.config/Cursor |
故障排除
“找不到配置文件”错误
使用确保配置文件存在 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"]
}
}
}许可证
麻省理工学院