全局规则管理服务器

MCP全局规则服务器

用于跨不同项目管理全局游标规则文件（“g-*.mdc”）的模型上下文协议（MCP）服务器实现。

特性

• 加载全局规则：将全局规则从配置的源复制到目标项目
• 保存全局规则：将全局规则从目标项目复制到全局存储
• 错误处理：配置和操作问题的详细错误消息
• JSON配置：简单的基于JSON的配置系统

先决条件

• Node.js 18+
• npm或yarn包管理器

安装

1. 克隆或下载此项目
2. 安装依赖项：

npm install

3. 通过创建配置服务器 config.json 文件：

cp config.example.json config.json

编辑 config.json 并设置全局规则目录的路径：

{
  "globalRulesSourceDir": "/path/to/your/project/.cursor/rules"
}

将MCP添加到光标

要将此MCP服务器添加到游标，请执行以下操作：

1. 先构建项目:

   复制

   npm run build
   

2. 打开光标设置:

   • 转到光标→ 设置（或按 Cmd+, 在Mac上/ Ctrl+, 在Windows/Linux上）
   • 导航到“扩展”或搜索“MCP”

3. 配置MCP:

   • 查找MCP设置部分
   • 添加新的MCP服务器配置：
     复制

     {
       "name": "global-mdc",
       "command": "node",
       "args": ["path/to/global-mdc/dist/index.js"]
     }
     

   • 替换 path/to/global-mdc 此项目目录的绝对路径

4. 重新启动游标 应用更改

重要提示

⚠️ 更改后 config.json:

1. 重建项目：运行 npm run build
2. 在光标设置中切换MCP：在游标设置中禁用然后重新启用MCP服务器
3. 重新启动游标 如果更改未生效

这是必需的，因为配置是在服务器启动时读取的，Cursor需要重新启动MCP服务器以获取新的配置。

MCP工具使用

服务器提供两个工具：

loadGlobalRules

将全局规则（“g-*.mdc”）加载到目标项目。

输入架构:

• path （string）：包含.cursor/rules的目标项目目录的绝对路径

输出：JSON对象包含：

• success （boolean）：操作是否成功
• errors （array，可选）：如果操作失败，则返回错误对象数组

saveGlobalRules

将全局规则（“g-*.mdc”）从目标项目保存到全局存储。

输入架构:

• path （string）：包含.cursor/rules的源项目目录的绝对路径

输出：格式与 loadGlobalRules

许可证

麻省理工学院