MCP全局规则服务器
用于跨不同项目管理全局游标规则文件(“g-\*.mdc”)的模型上下文协议(MCP)服务器实现。
特性
- 加载全局规则:将全局规则从配置的源复制到目标项目
- 保存全局规则:将全局规则从目标项目复制到全局存储
- 错误处理:配置和操作问题的详细错误消息
- JSON配置:简单的基于JSON的配置系统
先决条件
- Node.js 18+
- npm或yarn包管理器
安装
- 克隆或下载此项目
- 安装依赖项:
npm install- 通过创建配置服务器
config.json文件:
cp config.example.json config.json编辑 config.json 并设置全局规则目录的路径:
{
"globalRulesSourceDir": "/path/to/your/project/.cursor/rules"
}将MCP添加到光标
要将此MCP服务器添加到游标,请执行以下操作:
- 先构建项目:
npm run build- 打开光标设置:
- 转到光标→ 设置(或按 Cmd+, 在Mac上/ Ctrl+, 在Windows/Linux上) - 导航到“扩展”或搜索“MCP”
- 配置MCP:
- 查找MCP设置部分 - 添加新的MCP服务器配置:
{
"name": "global-mdc",
"command": "node",
"args": ["path/to/global-mdc/dist/index.js"]
}- 替换 path/to/global-mdc 此项目目录的绝对路径
- 重新启动游标 应用更改
重要提示
⚠️ 更改后 config.json:
- 重建项目:运行
npm run build - 在光标设置中切换MCP:在游标设置中禁用然后重新启用MCP服务器
- 重新启动游标 如果更改未生效
这是必需的,因为配置是在服务器启动时读取的,Cursor需要重新启动MCP服务器以获取新的配置。
MCP工具使用
服务器提供两个工具:
loadGlobalRules
将全局规则(“g-\*.mdc”)加载到目标项目。
输入架构:
path(string):包含.cursor/rules的目标项目目录的绝对路径
输出:JSON对象包含:
success(boolean):操作是否成功errors(array,可选):如果操作失败,则返回错误对象数组
saveGlobalRules
将全局规则(“g-\*.mdc”)从目标项目保存到全局存储。
输入架构:
path(string):包含.cursor/rules的源项目目录的绝对路径
输出:格式与 loadGlobalRules
许可证
麻省理工学院
