RyRank

Name: RyRank
Author: trigeochiral

本地服务

trigeochiral.com搜索与检索08 周前更新

代码仓库访问官网

关于 RyRank

RyRank 是按查询相关性重排文档的 MCP 服务，适用于 RAG 及文档或工具候选列表。它返回兼容 Cohere 的结果格式，也支持 Cohere v2 和 Voyage 的重排 API 格式。

主要功能

01按查询重排文档
02兼容 Cohere 的响应格式
03支持 Cohere v2 和 Voyage API 格式
04候选项缩减、去重与分流

适用场景

01重排 RAG 检索出的文档
02排列工具或文档候选列表
03对检索候选项去重并分流

MCP 相关

向 MCP 客户端提供 `rerank` 工具，按查询对文档排序。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "trigeochiral-ryrank": {
      "command": "uvx",
      "args": [
        "ryrank-mcp"
      ],
      "env": {
        "RYRANK_API": "<RYRANK_API>",
        "RYRANK_XPAYMENT": "<RYRANK_XPAYMENT>"
      }
    }
  }
}

启动命令uvx ryrank-mcp

需要配置的环境变量

RYRANK_APIBase URL of the hosted RyRank API (default https://trigeochiral.com)

RYRANK_XPAYMENT密钥Optional base64 x402 X-PAYMENT payload for paid calls past the free tier

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiryrank-mcp1.0.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
query	string	是	用于排序的查询
top_n	integer	否	仅返回前 N 个结果（默认值：全部）
documents	array	是	2–1000 份文档（字符串）
return_documents	boolean	否	在每个结果中包含文档文本

详细介绍

RyRank — MCP 服务

兼容 Cohere 的重排器，通过 x402 在 Base 上按次使用 USDC 付费，提供免费额度，无需注册。

托管 API：https://trigeochiral.com — 将其设为 RYRANK_API。

工具

工具	说明
`rerank`	根据与查询的相关性对文档重新排序。响应格式兼容 Cohere（`results: [{index, relevance_score}]`），可直接用于现有的 `co.rerank()` 调用。通过 x402 使用时，每次调用约 $0.001（大约是 Cohere Rerank 标价的一半），也可使用免费额度。

优势

这是一种混合重排器，而非交叉编码器：当候选项与查询已经共享词汇时效果很好，这也是 RAG 检索结果以及文档／工具候选列表中的常见情况。它专为高频、对延迟和成本敏感的重排而打造——例如缩小检索候选集、去重和分诊——而非对措辞几乎相同的内容进行精细的语义消歧。按次付费且价格约为一半，是为此做出的取舍。

已使用真实的 cohere.Client、cohere.ClientV2 和 voyageai.Client SDK 验证：将 base_url 指向此 API，现有重排代码无需修改即可运行。

安装

pip install ryrank-mcp
claude mcp add ryrank --env RYRANK_API=https://trigeochiral.com -- ryrank-mcp

或使用 uvx（无需安装）：

claude mcp add ryrank --env RYRANK_API=https://trigeochiral.com -- uvx ryrank-mcp

可选：设置 RYRANK_XPAYMENT，其值为 base64 编码的 x402 X-PAYMENT 载荷，即可在超出免费额度后进行付费调用。不设置时，每个 IP 每天可免费调用 25 次。

直接使用 HTTP（无需 MCP）

curl -sX POST https://trigeochiral.com/v1/rerank -H 'content-type: application/json' \
  -d '{"query":"how do I reset my password","documents":["Go to Settings > Security and click Reset Password.","Our refund policy allows returns within 30 days."],"top_n":2}'

此外，也支持完全兼容 Cohere v2（POST /v2/rerank）和 Voyage（POST /voyage/v1/rerank）的请求与响应格式，因此只需覆盖 base_url，即可使用其官方 SDK，无需修改代码 — 详情请参阅 https://trigeochiral.com。