rap2-mcp

RAP2 MCP工具

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

安装

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

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

配置

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

{
  "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 部分

使用

快速启动

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

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

查看帮助信息：

./start.sh --help

通过Cursor插件使用

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

主要功能

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

开发者信息

如需贡献代码或报告问题，请访问我们的GitHub仓库：rap-mcp