使用说明
用于游标的Orcho MCP服务器
AI编码提示的风险评估 -在执行之前自动分析您的编码请求的安全性和安全风险。
🚀 快速安装
单击此链接可在Cursor中自动安装:
cursor://anysphere.cursor-deeplink/mcp/install?name=orcho&config=eyJuYW1lIjoib3JjaG8iLCJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvcmNob19yaXNrL21jcC1zZXJ2ZXIiXSwiZW52Ijp7Ik9SQ0hPX0FQSV9LRVkiOiJ0ZXN0X2tleV9vcmNob18xMjM0NSJ9fQ==
如何使用:
- 复制上面的链接
- 将其粘贴到浏览器的地址栏中,然后按Enter键
- 游标将打开并自动配置MCP服务器
- 更换测试API密钥 使用您的真实密钥(请参见 API配置)
- 重新启动游标 激活
- 更换测试API密钥 使用您的真实密钥(请参见 API配置)
- 重新启动游标 激活MCP服务器
Orcho是什么??
Orcho实时分析您的编码提示,以在生成或执行代码之前识别潜在的安全风险、危险操作和安全问题。
特性
- 🔍 实时风险评估 -使用Orcho的风险分析API分析提示
- 📁 上下文感知 -自动包含文件上下文,以进行精确的爆炸半径和复杂性分析
- 🛡️ 安全第一 -执行前识别高风险提示
- 🔌 无缝集成 -本机使用Cursor的模型上下文协议
安装
选项1:一键安装(推荐)
将此链接复制并粘贴到浏览器中:
cursor://anysphere.cursor-deeplink/mcp/install?name=orcho&config=eyJuYW1lIjoib3JjaG8iLCJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvcmNob19yaXNrL21jcC1zZXJ2ZXIiXSwiZW52Ijp7Ik9SQ0hPX0FQSV9LRVkiOiJ0ZXN0X2tleV9vcmNob18xMjM0NSJ9fQ==
这会自动:
- ✅ 在Cursor中配置MCP服务器
- ✅ 通过npx设置自动安装
- ⚠️ 下一步:将测试API密钥替换为真实密钥(请参见下文)
- ⚠️ 然后:重新启动游标
选项2:手动安装
-
安装软件包:
npm install -g @orcho_risk/mcp-server -
配置光标:
创建或编辑
~/.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" } } } } -
重新启动游标 完全(退出并重新打开)
API配置
获取API密钥
- 注册 在 App.orcho.ai
- 导航到API设置 (仪表板→ API密钥)
- 创建或复制API密钥
- 更新您的
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服务器未加载
-
检查
mcp.json位置:- Mac/Linux:
~/.cursor/mcp.json - 窗户:
C:\Users\<YourUsername>\.cursor\mcp.json
- Mac/Linux:
-
验证是否安装了Node.js:
node --version # Requires v18+ -
检查游标开发工具:
- Help → 切换开发人员工具
- 在Console中查找与MCP相关的错误
API错误
- API密钥无效:验证密钥是否正确
mcp.json - 速率限制:请在以下网址查看您的帐户配额 App.orcho.ai
- 没有API密钥:默认情况下,服务器将使用测试密钥(功能有限)
还有问题吗?
- 检查Cursor是否完全重新启动(退出并重新打开)
- 在验证您的API密钥是否有效 App.orcho.ai
- 确保您有互联网连接
许可证
麻省理工学院
支持
对于问题和疑问:
- GitHub问题:[您的回购URL]
- Orcho支持:[支持URL]
