KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

cursorapi2any

★ 39 Open GitHub ↗

让 Cursor Pro 用户通过第三方中转站使用任意 LLM 模型的 API 代理服务。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CursorAPI2Any

让 Cursor Pro 用户通过第三方中转站使用任意 LLM 模型的 API 代理服务。

支持将 **OpenAI Chat Completions**、**Anthropic Messages** 和 **OpenAI Responses** 三种 API 格式无缝转发至上游 AI 服务，并提供可视化管理面板进行配置。

---

## 🏗️ 架构

三种入口协议 × 三种上游后端协议的协议桥：

```
Cursor                        CursorAPI2Any                          中转站
  │                                 │                                   │
  ├─ /v1/chat/completions ─────→ chat.ts ──────┬─ openai 后端 ────────→ /v1/chat/completions
  │                                             ├─ anthropic 后端 ────→ /v1/messages
  │                                             └─ responses 后端 ───→ /v1/responses
  │
  ├─ /v1/responses ────────────→ responses.ts ─┬─ openai 后端 ───────→ /v1/chat/completions
  │                                             ├─ anthropic 后端 ───→ /v1/messages
  │                                             └─ responses 后端 ───→ /v1/responses
  │
  └─ /v1/messages ─────────────→ messages.ts ─────────────────────────→ /v1/messages
```

---

## ✨ 功能特性

- **多协议支持** — 同时兼容 OpenAI (`/v1/chat/completions`)、Anthropic (`/v1/messages`) 和 Responses (`/v1/responses`) 三种 API 格式
- **智能协议转换** — 自动在 OpenAI ↔ Anthropic ↔ Responses 格式之间转换
- **模型路由映射** — 可将任意请求模型名映射到不同的上游模型、后端协议和 API 地址
- **流式响应 (SSE)** — 完整支持流式和非流式两种请求模式
- **可视化管理面板** — 内置 Web UI，支持在线配置上游地址、密钥和模型映射
- **Thinking 标签处理** — 自动提取和注入 `<think>` 推理标签和 Anthropic thinking blocks
- **Tool Calling 兼容** — 修复不同 API 间的工具调用格式差异
- **访问鉴权** — 可选的 Bearer Token / API Key 鉴权保护
- **多种部署方式** — 支持 Docker、PM2 和直接运行
- **优雅关停** — 支持 SIGTERM/SIGINT 信号的 Graceful Shutdown

---

## 📦 快速开始

### 环境要求

- **Node.js** >= 18.0
- **npm** >= 8.0

### 安装

```bash
# 克隆项目
git clone https://github.com/7836246/cursorapi2any.git
cd cursorapi2any

# 安装依赖
npm install

# 复制配置模板
cp .env.example .env
```

### 配置

编辑 `.env` 文件：

```env
# 上游 API 地址（也可在管理面板中配置）
PROXY_TARGET_URL=https://api.openai.com

# 上游 API 密钥（也可在管理面板中配置）
PROXY_API_KEY=sk-xxx

# 服务监听端口
PROXY_PORT=3029

# 请求超时时间（秒）
API_TIMEOUT=300

# 访问鉴权密钥（留空则不启用鉴权，同时也是管理面板登录密码）
ACCESS_API_KEY=

# 调试模式：开启后输出详细的请求/响应日志
DEBUG=false
```

### 运行

```bash
# 开发模式（热重载）
npm run dev

# 生产模式
npm run build
npm start
```

启动后访问：
- **API 端点**：`http://localhost:3029/v1`
- **管理面板**：`http://localhost:3029/admin`
- **健康检查**：`http://localhost:3029/health`

---

## 🐳 Docker 部署

```bash
# 使用 Docker Compose
docker-compose up -d

# 或手动构建
docker build -t api2cursor-ts .
docker run -d \
  -p 3029:3029 \
  --env-file .env \
  -v ./data:/app/data \
  --name api2cursor-ts \
  api2cursor-ts
```

---

## 🚀 PM2 部署

```bash
# 一键部署（安装依赖 + 编译 + 启动）
chmod +x deploy.sh
./deploy.sh

# 或手动操作
npm ci
npm run build
pm2 start ecosystem.config.js

# 常用命令
pm2 status              # 查看状态
pm2 logs api2cursor     # 查看日志
pm2 restart api2cursor  # 重启服务
pm2 stop api2cursor     # 停止服务
```

---

## 🔌 API 端点

### Chat Completions（OpenAI 格式）

```bash
curl http://localhost:3029/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-access-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'
```

### Messages（Anthropic 格式）

```bash
curl http://localhost:3029/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-access-key" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [{"role": "user", "content": "Hello!"}],
    "max_tokens": 1024
  }'
```

### Responses（OpenAI Responses 格式）

```bash
curl http://localhost:3029/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-access-key" \
  -d '{
    "model": "gpt-4o",
    "input": "Hello!",
    "stream": true
  }'
```

### 模型列表

```bash
curl http://localhost:3029/v1/models \
  -H "Authorization: Bearer your-access-key"
```

---

## ⚙️ 模型映射

通过管理面板（`/admin`）或直接编辑 `data/settings.json` 配置模型映射。每个映射支持以下字段：

| 字段 | 说明 | 示例 |
|------|------|------|
| `upstream_model` | 上游实际模型名 | `claude-sonnet-4-5` |
| `backend` | 后端协议类型 | `openai` / `anthropic` / `responses` / `auto` |
| `target_url` | 独立上游地址（可选，覆盖全局配置） | `https://api.anthropic.com` |
| `api_key` | 独立 API 密钥（可选，覆盖全局配置） | `sk-xxx` |

配置示例：

```json
{
  "model_mappings": {
    "gpt-4o": {
      "upstream_model": "claude-sonnet-4-5",
      "backend": "anthropic"
    },
    "my-custom-model": {
      "upstream_model": "gpt-4o",
      "backend": "openai",
      "target_url": "https://my-other-api.com",
      "api_key": "sk-other-key"
    }
  }
}
```

当 `backend` 设为 `auto` 或留空时，服务会根据模型名自动判断：模型名包含 `claude` 或 `anthropic` 则走 Anthropic 协议，否则走 OpenAI 协议。

---

## 🏗️ 项目结构

```
api2cursor-ts/
├── src/
│   ├── index.ts                  # 服务入口，启动 HTTP 服务器
│   ├── app.ts                    # Express 应用工厂（中间件、鉴权、错误处理）
│   ├── config.ts                 # 环境变量配置
│   ├── settings.ts               # 持久化设置管理（data/settings.json）
│   ├── routes/
│   │   ├── index.ts              # 路由注册
│   │   ├── chat.ts               # /v1/chat/completions 路由
│   │   ├── messages.ts           # /v1/messages 路由
│   │   ├── responses.ts          # /v1/responses 路由
│   │   ├── admin.ts              # 管理面板 + /v1/models 路由
│   │   └── common.ts             # 路由公共工具函数
│   ├── adapters/
│   │   ├── ccAnthropicAdapter.ts # Chat Completions ↔ Anthropic Messages 转换
│   │   ├── responsesCcAdapter.ts # Responses ↔ Chat Completions 转换
│   │   └── openaiCompatFixer.ts  # OpenAI 兼容性修复
│   └── utils/
│       ├── http.ts               # HTTP 请求、SSE 流解析工具
│       ├── toolFixer.ts          # Tool Call 格式修复
│       └── thinkTag.ts           # <think> 推理标签处理
├── static/                       # 管理面板前端资源
│   ├── admin.html
│   ├── admin.js
│   └── admin.css
├── data/                         # 运行时数据（git 忽略）
│   └── settings.json
├── .env.example                  # 环境变量模板
├── Dockerfile                    # Docker 多阶段构建
├── docker-compose.yml            # Docker Compose 配置
├── ecosystem.config.js           # PM2 进程管理配置
├── deploy.sh                     # PM2 一键部署脚本
├── tsconfig.json                 # TypeScript 编译配置
└── package.json
```

---

## 🛡️ 鉴权说明

设置 `ACCESS_API_KEY` 环境变量后：

- 所有 `/v1/*` API 路径将要求在请求头中携带鉴权信息
- 支持 `Authorization: Bearer <key>` 或 `x-api-key: <key>` 两种方式
- 管理面板 (`/admin`) 登录时使用同一密码
- 留空则不启用鉴权（不推荐在公网环境使用）

---

## 🖥️ 在 Cursor 中配置

1. 打开 Cursor 设置 → Models
2. 添加自定义模型，名称填映射中配置的 Cursor 模型名
3. Override OpenAI Base URL 填 `http://localhost:3029`
4. API Key 填 `ACCESS_API_KEY` 的值（未配置则随意填）

> **提示**：使用 Claude 风格的模型名（如 `claude-sonnet-4-5-20250929`）可以让 Cursor 显示思考过程（thinking）。

---

## 🔧 兼容性修复

代理自动处理以下兼容性问题：

- Cursor 扁平格式 tools → 标准 OpenAI 嵌套格式
- `reasoningContent` → `reasoning_content`
- `<think>` 标签 → `reasoning_content`
- 旧版 `function_call` → 新版 `tool_calls`
- `tool_calls` 缺失 `id` / `index` / `type` 字段补全
- 智能引号 → 普通引号（StrReplace 工具精确匹配修复）
- `file_path` → `path` 字段映射
- `finish_reason` 修正

---

## 🙏 致谢

本项目基于 [api2cursor](https://github.com/h88782481/api2cursor) 重写，感谢原作者 [@h88782481](https://github.com/h88782481) 的出色工作。

---

## 📄 License

MIT

cursorapi2any

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README