cursor-byok

项目概述

cursor-byok 是一个开源的 Cursor 本地模型网关。它在本地运行服务，将 Cursor 连接到你配置的模型 API，通过自己的提供商路由模型请求，并保留 Cursor Agent 的工具调用、Skills 和 MCP 等能力。

主要功能

• 自有模型通道：配置自己的 API 端点、凭证和模型 ID
• 多 API 协议：支持 OpenAI 和 Anthropic 兼容 API
• 模型管理：添加、复制、编辑、排序和批量测试多个模型配置
• 连接基准测试：测量首 token 时间、生成速度等
• Agent 工作流：保持工具调用、Skills、MCP 和多轮对话
• 会话指标：追踪 token 使用、缓存命中率、对话轮次等
• 跨平台：支持 macOS、Windows 和 Linux

适用人群

• Cursor 用户，希望使用自有模型和 API 密钥
• 需要自定义模型通道的开发者
• 希望自托管相关服务的团队

快速上手

1. 从 GitHub Releases 下载对应平台的最新版本
2. 启动 cursor-byok，打开 Model Settings，输入端点、API 密钥和模型 ID
3. 测试模型配置，通过后返回仪表盘启动服务
4. 升级 Cursor 或首次配置模型后，完全退出 Cursor 并重启

核心优势

• 将模型选择权交还给用户
• 保留 Cursor Agent 的完整能力
• 支持 OpenAI 和 Anthropic 两种协议
• 跨平台支持

系统要求

• 操作系统：macOS、Windows、Linux