encyport

Name: encyport
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords搜索与检索02 周前更新

代码仓库

关于 encyport

encyport 是用于搜索 Wikipedia 并获取文章内容及结构化页面信息的 MCP 服务和命令行工具。它使用 Wikipedia 公共 API，无需 API 密钥。

主要功能

01搜索匹配的文章
02获取完整文章文本
03获取导读摘要和章节大纲
04列出链接页面及其状态
05获取记录的坐标

适用场景

01查找某主题的 Wikipedia 文章
02获取文章摘要或全文
03查看文章链接、章节或坐标

MCP 相关

提供 MCP 工具，通过 Wikipedia 公共 API 搜索文章并获取正文、摘要、章节、链接和坐标。

配置

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

mcp.json · 通用配置

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

启动命令npx -y @reneturcios/encyport

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

安装包

npm@reneturcios/encyport0.1.0stdio

ocighcr.io/cloudcorprecords/encyport:0.1.0stdio

工具

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

参数	类型	必填	说明
limit	integer	否	要返回的搜索结果数上限（可选；默认为 10，限制在 1–50 之间）。
query	string	是	用于匹配 Wikipedia 文章标题和内容的搜索文本。

详细介绍

encyport

encyport 会读取 Wikipedia，因此用户和 Agent 无需自己抓取内容。提供一个短语，它就会查找匹配的文章；提供一个标题，它就会返回文章全文、仅含导语的摘要、章节大纲、文章链接的页面，或该主题记录的坐标——所有数据均来自 en.wikipedia.org 上公开的 Wikipedia API，无需注册，也无需 API 密钥。

安装

npx @reneturcios/encyport search "analytical engine"

也可以运行容器映像：

docker run -i ghcr.io/cloudcorprecords/encyport

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

CLI

每条命令都会输出 JSON。

# Search for articles
encyport search Ada Lovelace
encyport search black holes --limit 5

# Read a page four ways, plus its coordinates
encyport article Ada Lovelace
encyport summary Ada Lovelace
encyport sections Ada Lovelace
encyport links Ada Lovelace
encyport coordinates Eiffel Tower

encyport --version

标题和查询可以包含空格；命令词之后的所有内容都会合并为一个短语。退出代码：成功时为 0，查找失败时为 1（例如页面不存在或上游错误，消息中会说明原因），用法错误时为 2。

MCP 服务

一个可执行文件同时支持这两种用法。mcp 子命令会启动一个 stdio MCP 服务：

npx -y @reneturcios/encyport mcp

MCP 客户端配置：

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

工具

工具	输入	返回内容
`search_wikipedia`	`query`（字符串，必填）、`limit`（整数，可选）	匹配的文章：每条结果都包含标题、页面 ID、清理后的文本片段、字数和最后修订时间戳。
`get_article`	`title`（字符串，必填）	文章的完整纯文本内容。
`get_summary`	`title`（字符串，必填）	文章的导语部分，采用纯文本格式——也就是大多数读者所说的“摘要”。
`get_sections`	`title`（字符串，必填）	文章的章节大纲：按文档顺序列出章节编号、标题、标题级别和解析索引。
`get_links`	`title`（字符串，必填）	该文章链接到的页面，并注明每个页面的命名空间及目标页面是否存在。
`get_coordinates`	`title`（字符串，必填）	页面记录的纬度/经度坐标对（主题没有坐标时为空），并标记主要坐标。

标题会跟随重定向，因此常用名称或旧标题仍会跳转到当前文章。无法解析为页面的标题会报告错误，而不会返回空内容。

开发

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

核心模块接受可注入的 fetch 函数，测试套件完全使用手写的载荷来驱动它，这些载荷按照真实 Wikipedia API 响应的格式构造——测试不会访问网络。