# RAP2 MCP工具

这个工具提供了RAP2 API的MCP接口，使你可以通过AI助手查询和使用RAP2 API文档。

## 安装

```bash
# 克隆仓库
git clone https://github.com/yourusername/rap-mcp.git
cd rap-mcp

# 运行安装脚本
chmod +x install.sh
./install.sh
```

## 配置

安装完成后，您需要在Cursor的MCP配置文件中添加RAP2 MCP服务器配置。建议使用以下格式：

```json
{
  "mcpServers": {
    "RAP2 MCP": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "/path/to/rap2-mcp/rap2_mcp_server.py",
        "--rap2-url=http://rap2api.taobao.org",
        "--rap2-sid=您的koa.sid值",
        "--rap2-sid-sig=您的koa.sid.sig值"
      ]
    }
  }
}
```

### 参数获取方式

RAP2 MCP工具支持以下几种参数获取方式（按优先级从高到低）：

1. **请求头传递**：通过HTTP请求头传递参数
   - `X-RAP2-BASE-URL`: RAP2服务器地址
   - `X-RAP2-SID`: koa.sid Cookie值
   - `X-RAP2-SID-SIG`: koa.sid.sig Cookie值

2. **命令行参数**：通过命令行参数传递
   ```
   --rap2-url=http://rap2api.taobao.org --rap2-sid=您的koa.sid值 --rap2-sid-sig=您的koa.sid.sig值
   ```

### MCP配置文件位置

- macOS/Linux: `~/.cursor/mcp.json`
- Windows: `%USERPROFILE%\.cursor\mcp.json`

### 获取RAP2 Cookie值

1. 使用浏览器登录RAP2
2. 打开开发者工具（F12）
3. 切换到Network（网络）标签页
4. 刷新页面，选择任意请求
5. 在Headers中找到Cookie字段
6. 从Cookie中提取以下两个值:
   - `koa.sid=xxxxxx` 中的 xxxxxx 部分
   - `koa.sid.sig=yyyyyy` 中的 yyyyyy 部分

## 使用

### 快速启动

安装完成后，可以使用以下命令快速启动服务器：

```bash
./start.sh --url=http://rap2api.taobao.org --sid=您的koa.sid值 --sid-sig=您的koa.sid.sig值
```

查看帮助信息：

```bash
./start.sh --help
```

### 通过Cursor插件使用

配置完成后，在Cursor IDE中启用RAP2 MCP插件即可使用。

## 主要功能

- **查询接口详情**：获取指定ID的接口信息
- **获取仓库接口**：获取指定仓库中的所有接口
- **搜索接口**：通过关键词搜索接口
- **生成API代码**：根据接口生成前端调用代码（支持fetch、axios、react-query）
- **测试连接**：测试与RAP2服务器的连接状态

## 开发者信息

如需贡献代码或报告问题，请访问我们的GitHub仓库：[rap-mcp](https://github.com/yourusername/rap-mcp)