citesearch

citesearch

citesearch 是 Edgepedia 的一个小型客户端。Edgepedia 是一个独立的百科语料库，据其自己的发行说明称，包含约 486,000 篇文章，每篇都有自己的 ID 和署名行。它可以按主题搜索语料库、完整阅读文章或主题、列出与已有文章相关的文章、追踪两篇文章之间的文内链接链，并在你提供少量上下文时，确定含义模糊的名称指的是哪篇文章。一个二进制文件同时提供命令行界面和 stdio MCP 服务。

无需账户或 API 密钥。在底层，这两种接口都会将每个请求转发到托管的 Edgepedia 端点 https://www.edgechat.ai/mcp，并打印返回的文本。文章带有署名行；如果上游文本包含署名行，客户端会按原样显示——复用文章文本时，请始终保留署名行。

安装

npx @reneturcios/citesearch search koala

或者运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/citesearch

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

citesearch search Mount Fuji
citesearch fetch ep9kcz7eym
citesearch fetch ep9kcz7eym --no-citations
citesearch related ep9kcz7eym
citesearch connect epStart epTarget
citesearch resolve Jaguar --context "British car maker"

citesearch --version

结果以纯文本形式打印——搜索会返回匹配的文章及其 ID、标题、链接和摘要；获取会将一篇文章以 Markdown 格式返回，并附带其链接、日期、主题、许可证和署名行；解析会指出所指的文章、置信度和其他候选项。退出代码：成功时为 0，上游请求失败时为 1，用法错误时为 2。发出任何请求前都会验证参数。

关于 fetch 的说明：启用引用时（默认设置），文章来源会显示为内联链接；使用 --no-citations 则会改用 [n] 标记，文本长度大约会缩短四分之一。上游文档还提到可以一次获取多个 ID、获取单个章节、设置令牌预算或仅获取匹配段落——但它没有公布这些控制项的参数名称，因此此客户端不会凭空编造：fetch 只接受一个 ID 和引用开关。

MCP 服务

一个二进制文件同时提供两种接口。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/citesearch mcp

MCP 客户端配置：

{
  "mcpServers": {
    "citesearch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/citesearch", "mcp"]
    }
  }
}

工具

五种工具均为只读，且无需密钥。

工具	输入	返回内容
search	query（字符串）——主题名称，而非问题	匹配的文章：ID、标题、链接和摘要（没有摘要时则返回文章开头）。其他名称和拼写错误也能使用；主题短语会返回该主题。
fetch	id（字符串）；citations（布尔值，可选）	将一篇文章以 Markdown 格式返回，并附带其链接、日期、主题、许可证和署名行。主题的 ID 会列出其文章。citations: false 会将内联来源链接替换为 [n] 标记。
related	id（字符串）	与该文章相关的文章：同主题文章、每个相邻主题中的若干篇文章，以及地理位置相邻的文章。
connect	from（字符串），to（字符串）	从一篇文章到另一篇文章的最短文内链接链（最多 6 跳），并附上每一跳对应的句子。
resolve	name（字符串）；context（字符串，可选）	指出该名称所指的文章，并提供置信度和其他候选项。例如，“Jaguar”与“英国汽车制造商”搭配时指汽车公司，与“大型猫科动物”搭配时则指动物。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch only)
npm run dev     # run the CLI from source via tsx

许可证

MIT——参见 LICENSE。（此许可证适用于此客户端；Edgepedia 文章文本采用其自身许可证，并附有自己的署名行。）