Searchport

io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 7, 2026

Web, local, news, image, and video search through the Brave Search API.

已验证STDIO仅桌面位置与生活网页搜索与抓取

概览

AI 生成的概览

Searchport 通过本地 stdio MCP 服务器为助手提供 Brave 搜索的五类工具：网页、本地、新闻、图片和视频搜索。

可以做什么
  • 搜索通用网页索引，返回标题、链接和摘要
  • 查找附近的商家和地点，返回地址、电话和评分等详情
  • 检索最新新闻报道，返回来源、摘要和发布时间
  • 查找图片，返回来源页面和图片直链
  • 查找视频，返回描述、时长和来源
适用场景
当助手需要实时的网页、新闻、本地商家、图片或视频搜索结果，且你已拥有 Brave Search API 订阅时适用。它用一个服务器统一覆盖这五类搜索。
运行要求
需要 Brave Search API 订阅密钥，通过 BRAVE_API_KEY 环境变量提供，并以 X-Subscription-Token 请求头发送给 API。通过 npx（需 Node.js）或 Docker 镜像在本地运行，并需能访问 Brave Search API 的网络。仅支持桌面端。
安装前请注意
需要付费的 Brave Search API 订阅密钥，缺少 BRAVE_API_KEY 时所有搜索都会失败。查询内容和结果会发送给第三方 Brave Search API。该服务器只读取搜索结果，不写入或删除数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Searchport，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

searchport

searchport is one doorway to five kinds of Brave search. A single question can be asked against the general web index, local business listings, current news, images, or videos, and every answer comes back in the same shape: a title, the address it lives at, a short excerpt, and one extra line of detail that fits the kind — how long ago a story ran, how long a video plays, where a shop is and how it is rated. It runs from the command line or as an MCP server for agents.

A Brave Search API subscription key is required. Put it in the BRAVE_API_KEY environment variable; the key is sent to the API as the X-Subscription-Token header and never appears in output. When the variable is missing, every search fails with an error that names it.

Install

bash
npx @reneturcios/searchport web "trail running shoes"

Or run the container image:

bash
docker run -i -e BRAVE_API_KEY ghcr.io/cloudcorprecords/searchport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
export BRAVE_API_KEY="your subscription key"
# General web search; --count is results per page (max 20),# --offset pages forward (max 9)searchport web "composting basics"searchport web "composting basics" --count 5 --offset 1
# The other four kinds take the same query and --countsearchport local "bakery near the mission" --count 5searchport news "trail network vote"searchport images "ridge sunrise"searchport videos "trail running form"
# Machine-readable output for any kindsearchport web "composting basics" --json
searchport --version

Exit codes: 0 on success, 1 when a search fails (including a missing BRAVE_API_KEY or an API error), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/searchport mcp

MCP client configuration:

json
{  "mcpServers": {    "searchport": {      "command": "npx",      "args": ["-y", "@reneturcios/searchport", "mcp"],      "env": { "BRAVE_API_KEY": "your subscription key" }    }  }}

Tools

ToolInputWhat it returns
brave_web_searchquery (string, required), count (number, optional), offset (number, optional)Web results as a numbered text block: title, URL, and excerpt per result.
brave_local_searchquery (string, required), count (number, optional)Local listings: name, URL, and a detail line with address, phone, and rating when the API provides them.
brave_news_searchquery (string, required), count (number, optional)News stories: headline, URL, summary, and the story's age.
brave_image_searchquery (string, required), count (number, optional)Image results: title, source page URL, and the direct image URL.
brave_video_searchquery (string, required), count (number, optional)Video results: title, URL, description, and duration.

Counts are clamped to the API's per-page limit of 20 and offsets to its maximum of 9. An empty result set is reported as such, not as an error; a missing key or a failed API call is reported as a tool error.

Development

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

License

MIT — see LICENSE.

来源：README.md，提交 197c7f3

工具

5

版本历史

1
  1. v0.1.0最新Oct 31, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分