代码提示风险评估服务

Orcho MCP Server for Cursor 是一款实时分析编程提示的工具,用于识别潜在的安全风险、危险操作和安全问题,确保在代码生成或执行前进行风险评估。

  • by guardd
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 guardd/mcp_server

使用说明

用于游标的Orcho MCP服务器

AI编码提示的风险评估 -在执行之前自动分析您的编码请求的安全性和安全风险。

🚀 快速安装

单击此链接可在Cursor中自动安装:

cursor://anysphere.cursor-deeplink/mcp/install?name=orcho&config=eyJuYW1lIjoib3JjaG8iLCJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvcmNob19yaXNrL21jcC1zZXJ2ZXIiXSwiZW52Ijp7Ik9SQ0hPX0FQSV9LRVkiOiJ0ZXN0X2tleV9vcmNob18xMjM0NSJ9fQ==

如何使用:

  1. 复制上面的链接
  2. 将其粘贴到浏览器的地址栏中,然后按Enter键
  3. 游标将打开并自动配置MCP服务器
  4. 更换测试API密钥 使用您的真实密钥(请参见 API配置)
  5. 重新启动游标 激活
  6. 更换测试API密钥 使用您的真实密钥(请参见 API配置)
  7. 重新启动游标 激活MCP服务器

Orcho是什么??

Orcho实时分析您的编码提示,以在生成或执行代码之前识别潜在的安全风险、危险操作和安全问题。

特性

  • 🔍 实时风险评估 -使用Orcho的风险分析API分析提示
  • 📁 上下文感知 -自动包含文件上下文,以进行精确的爆炸半径和复杂性分析
  • 🛡️ 安全第一 -执行前识别高风险提示
  • 🔌 无缝集成 -本机使用Cursor的模型上下文协议

安装

选项1:一键安装(推荐)

将此链接复制并粘贴到浏览器中:

cursor://anysphere.cursor-deeplink/mcp/install?name=orcho&config=eyJuYW1lIjoib3JjaG8iLCJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvcmNob19yaXNrL21jcC1zZXJ2ZXIiXSwiZW52Ijp7Ik9SQ0hPX0FQSV9LRVkiOiJ0ZXN0X2tleV9vcmNob18xMjM0NSJ9fQ==

这会自动:

  • ✅ 在Cursor中配置MCP服务器
  • ✅ 通过npx设置自动安装
  • ⚠️ 下一步:将测试API密钥替换为真实密钥(请参见下文)
  • ⚠️ 然后:重新启动游标

选项2:手动安装

  1. 安装软件包:

    npm install -g @orcho_risk/mcp-server
    
  2. 配置光标:

    创建或编辑 ~/.cursor/mcp.json (Windows: C:\Users\<YourUsername>\.cursor\mcp.json):

    {
      "mcpServers": {
        "orcho": {
          "command": "npx",
          "args": ["-y", "@orcho_risk/mcp-server"],
          "env": {
            "ORCHO_API_KEY": "your-api-key-here"
          }
        }
      }
    }
    
  3. 重新启动游标 完全(退出并重新打开)


API配置

获取API密钥

  1. 注册 在 App.orcho.ai
  2. 导航到API设置 (仪表板→ API密钥)
  3. 创建或复制API密钥
  4. 更新您的 mcp.json 文件:
    • 地点: ~/.cursor/mcp.json (或 C:\Users\<YourUsername>\.cursor\mcp.json 在Windows上)
    • 替换 test_key_orcho_12345 使用您的实际API密钥

测试API密钥

对于初始测试,您可以使用:

test_key_orcho_12345

注: 测试密钥的功能和速率限制有限。从获取您自己的API密钥 App.orcho.ai 用于生产用途。

安全最佳实践

  • ✅ 存储API密钥 只有在 ~/.cursor/mcp.json (不在您的项目中)
  • ✅ 永不承诺 版本控制的API密钥
  • ✅ 旋转按键 如果意外暴露,立即

用法

手动评估

在光标聊天中,键入:

@orcho assess_risk: Your prompt here

自动评估(推荐)

通过在项目中添加游标规则,为所有提示启用自动风险评估。

选项1:项目规则(现代-推荐)

将规则文件复制到项目中:

# Create .cursor/rules directory
mkdir -p .cursor/rules

# Copy the rule file
cp node_modules/@orcho_risk/mcp-server/.cursor/rules/orcho-risk-assessment.mdc .cursor/rules/

或从以下位置手动复制:

node_modules/@orcho_risk/mcp-server/.cursor/rules/orcho-risk-assessment.mdc

选项2:旧版.cursorules文件

复制示例规则文件:

cp node_modules/@orcho_risk/mcp-server/.cursorrules.example .cursorrules

注: 项目规则(选项1)是现代方法,支持更多功能。


运作原理

情境感知评估

Orcho在可用时自动收集上下文:

  • 当前文件:检测编辑器中打开的文件
  • 其他文件:分析提示将修改哪些文件
  • 依赖图:可选项目依赖关系信息
  • 爆炸半径:计算更改的影响范围

示例

User: "Delete all user data from the database"
→ Cursor calls: @orcho assess_risk with context
→ Risk: HIGH (score: 95)
→ Cursor warns: "⚠️ HIGH RISK: This could cause data loss. Proceed?"

刀具参数

  • task (必填):评估提示
  • current_file (推荐):当前打开文件的路径
  • other_files (推荐):将被修改的文件数组
  • dependency_graph (可选):项目依赖关系图
  • weights (可选):自定义风险计算权重
  • aiignore_file (可选):.aiignore文件的路径

故障排除

MCP服务器未加载

  1. 检查 mcp.json 位置:

    • Mac/Linux: ~/.cursor/mcp.json
    • 窗户: C:\Users\<YourUsername>\.cursor\mcp.json
  2. 验证是否安装了Node.js:

    node --version  # Requires v18+
    
  3. 检查游标开发工具:

    • Help → 切换开发人员工具
    • 在Console中查找与MCP相关的错误

API错误

  • API密钥无效:验证密钥是否正确 mcp.json
  • 速率限制:请在以下网址查看您的帐户配额 App.orcho.ai
  • 没有API密钥:默认情况下,服务器将使用测试密钥(功能有限)

还有问题吗?

  • 检查Cursor是否完全重新启动(退出并重新打开)
  • 在验证您的API密钥是否有效 App.orcho.ai
  • 确保您有互联网连接

许可证

麻省理工学院

支持

对于问题和疑问:

  • GitHub问题:[您的回购URL]
  • Orcho支持:[支持URL]