Infobroker

一个服务器。所有来源。交付研究成果。

Infobroker 是一个多提供商 MCP 服务器，将网络搜索、结构化知识、学术、档案和内容提取 API 统一在单一工具界面之后。十五个零配置提供商开箱即用——搜索网络、查找事实、获取文章——无需任何配置。另外五个提供商可通过 API 密钥或自托管解锁。内置的佐证引擎交叉引用独立来源，将既定事实与有争议的说法区分开来。捆绑的客户端技能将原始研究转化为精炼的写作。免费优先。隐私始终。

北极星

Infobroker 是 Bothan Spynet 作为工具的实现——一个去中心化的情报网络，查询独立来源并通过单一、公正的界面路由结果。用情报周期的术语来说，你提供方向并获得传播；服务器处理收集和处理。

Related MCP server: openresearch-mcp

快速开始

cd Infobroker && npm install && npm run start

将此添加到你的 OpenCode 配置（~/.config/opencode/opencode.json）：

{
  "instructions": [
    "<path-to-Infobroker>/instructions/search-preferences.md"
  ],
  "skills": {
    "paths": [
      "<path-to-Infobroker>/skills",
      "<path-to-opencode-config>/skills"
    ]
  },
  "mcp": {
    "infobroker": {
      "type": "local",
      "command": ["node_modules/.bin/tsx", "src/index.ts"],
      "cwd": "<path-to-Infobroker>",
      "environment": {
        "INFOBROKER_CONFIG": "<path-to-Infobroker>/config.json"
      }
    }
  }
}

mcp 块启动服务器；instructions 和 skills 块用于激活捆绑的客户端技能。没有它们，技能会随仓库一起提供，但保持不活动状态。

免费提供商立即可用。API 密钥提供商——Brave、Exa、Tavily、Yep——解锁更高的吞吐量和专业化搜索；自托管的 SearXNG 提供完全的查询隐私：

export INFOBROKER_BRAVE_API_KEY="your-key"
export INFOBROKER_EXA_API_KEY="your-key"

要求：Node.js 20+。

MCP 服务器

你的研究后端。六个工具、二十个提供商、一个佐证引擎。完整的功能清单记录在规范中的功能分类法中。

统一搜索

"搜索第二颗死星的位置。" "查找关于超空间旅行理论的学术论文。"

web_search 将一次查询发送给每个能够回答它的提供商。跨 DuckDuckGo、Wikipedia、学术数据库、新闻、代码仓库进行搜索——或者描述你的任务，服务器会选择最佳来源。失败的提供商通过可配置的链静默回退，因此你得到的是结果，而不是错误消息。其他搜索工具将你锁定在一个引擎上；Infobroker 将每个查询路由到正确的提供商，并在一个失败时继续前进。

内容提取

"获取关于雅文战役的文章并总结它。" "获取那个关于死星计划的页面的文本。"

fetch_page 将任何 URL 交给 Jina Reader，后者将其渲染为针对 LLM 消费优化的干净 Markdown。当 Jina 被限流时回退到原生 HTTP。Wikipedia 和 Internet Archive 有专门针对特定来源提取的渲染器。内置的网页抓取器返回原始 HTML；Infobroker 从任何来源为你提供干净、可读的内容——随时可用于总结或分析。

提供商智能

"我应该用哪个来源来研究死星的弱点？" "显示所有可用来源及其配额状态。"

服务器知道自己的能力。web_search 为你的任务自动选择最佳后端，权衡能力、配额和延迟——或者当你要求隐私、速度或仅免费来源时，根据你的意图路由。providers 呈现每个已配置的来源，并深入查看单个提供商的正常运行时间和错误历史。没有其他搜索 MCP 服务器能让你对每个后端都有操作可见性。

多来源验证

"验证帝国是否真的摧毁了奥德兰。" "找出谁先开火的共识——汉还是格里多。"

corroborate 运行多轮真相查找循环：跨活动提供商的广泛搜索、声明提取、跨来源对账，以及针对差距的定向跟进。跨独立来源得到佐证的声明获得高置信度，按每个来源的权威性加权；每个来源都绑定到它所支持的声明。矛盾之处会呈现所有视角。差距会触发精炼的查询。你得到一份结构化报告——已确认、有争议和未验证的发现——带有来源出处、每个来源的声明和置信度分数。其他每个搜索工具都返回链接列表；Infobroker 找到真相并告诉你它有多确定。

知识库

"搜索你已经找到的关于义军同盟舰队的内容。" "摄取这篇文章，以便下次缓存。"

每次搜索、获取和佐证运行都缓存在本地知识库中。kb 在访问外部提供商之前检查缓存——仅在缓存结果不够新鲜或不够相关时才回退到网络。它的操作可以手动摄取新文本或 URL、报告已缓存的内容以及移除内容。内容按年龄评分，按新鲜度计划过期，并按来源去重。在缓存之外，kb 归档你生成的报告：使用 source_type: "report" 摄取（并默认使用知识库），然后用 kb list 和 kb get 重新访问它们，或者改为写入本地目录。其他搜索 MCP 服务器每次会话都重新获取相同的事实；Infobroker 记住并重用已经找到的内容。

研究管道

"研究死星的建造过程，然后起草一份总结。" "事实核查这些关于达斯·维达起源的说法。"

Infobroker 不止于搜索结果。捆绑的客户端技能将其工具串联成写作管道，将每个请求路由经过既定的工作流形态和写作子技能，直到另一端产出完成的文档。一切都存在于仓库中——没有外部路径或单独安装。完整管道——六项技能、工作流形态和升级路径——详见技能部分。其他搜索 MCP 服务器产生搜索结果；Infobroker 产生完成的作品。

操作可见性

"显示服务器健康状况。" "无需重启即可热重载我的配置。"

配额计数器持久化到磁盘，重启后依然保留。限流按提供商分别执行，而非全局统一。配置可通过 reload_config 热加载——修改提供商、调整链路或微调阈值，均无需断开连接。web_search 兼作 DuckDuckGo 查询自动补全。providers 报告服务器的构建健康状态和请求统计。你始终清楚自己的搜索服务器在做什么，以及还剩多少容量。

技能

MCP 服务器是产品的一半，内置技能是另一半。仓库中随附六个客户端技能——无外部依赖、无需单独安装——它们将原始研究转化为成品。

编排技能（infobroker）以分类门（classify gate）开场，将你的请求映射到一种工作流形态：研究并写作、事实核查、深度挖掘、竞品评估、文献综述、监控、红队、背景审查或门控分析。每种形态将相同的基本原语——知识库召回、搜索、提取、验证、写作和引用——组合成各自的序列，并以可 grep 的完成令牌收尾，以便你确认结果。四个写作子技能负责执行写作阶段：summarization 在写作前浓缩发现，technical-writing 起草报告和文档，proofreading 润色语言，translation 产出多语言输出。

门控分析是升级形态。当问题风险高或影响决策时，分类门会路由到 analysis-loop 技能——一条严谨的路径，包含置信度评分的发现、来源可靠性分级和结构化分析技术——而非较轻的研究并写作路线。它共享相同的基本原语和 Infobroker 工具，但运行自己的门控工作流，因此无需离开流水线即可获得严谨性。

一个指令文件 search-preferences.md 将你的客户端导向这些工具：优先知识库，仅当缓存不足时才使用外部提供商。将其与技能目录一次性接入你的 OpenCode 配置——上面的快速入门展示了确切代码片段——此后每个研究请求都会自动遵循该流水线。

在 skills/ 中编写你自己的技能，即可添加自己的工作流形态。流水线图位于 references/pipeline-map.md，工作流形态定义位于 references/workflows.md。其他搜索 MCP 服务器返回链接；Infobroker 随附将这些链接转化为有据可查答案的写作者。

提供商

二十个提供商。其中十五个零配置即可使用。

内置和免费 HTTP 提供商开箱即用。密钥提供商通过 API 密钥启用。自托管提供商指向你自己运行的服务器：

export INFOBROKER_BRAVE_API_KEY="BSA-..."
export INFOBROKER_SEARXNG_URL="http://localhost:8080"

然后在 config.json 中为该提供商设置 "enabled": true。

SearXNG 是唯一随附的自托管提供商，并且从头到尾都是可选的。服务器中没有任何内容依赖它，也没有任何内容为其捆绑或安装——SearXNG 作为你自行运维的容器运行，Infobroker 像查询任何其他后端一样查询其 JSON 端点。保持其禁用（默认状态）你不会损失任何东西：隐私关键链路仍通过 DuckDuckGo 和 Mojeek 提供服务。仅当你想要完全查询隐私时才启用它，此时只有你自己的 SearXNG 实例能看到你的查询。

配置

config.json 随仓库发布并持有默认值：哪些提供商已启用、它们在回退链路中的优先级、限流、佐证参数，以及任务到提供商的调度表。可通过 reload_config 热加载——编辑文件、调用工具，更改无需重启即可生效。

你自己的覆盖项位于单独的用户层——项目目录中的 config.local.json（或通过 INFOBROKER_CONFIG_LOCAL 设置的路径）。该文件被 git 忽略，因此从仓库拉取更新永远不会覆盖你的设置。用户层中的值优先于随附默认值；任何未设置的内容回退到 config.json。

知识库初始为空。默认情况下它写入仓库之外的用户作用域路径（~/.local/share/infobroker/knowledge-base），因此你研究和缓存的内容保留在你的机器上，永远不会被提交。每个部署实例都会积累自己的存储。

知识库加密

研究报告和缓存页面可能敏感，而知识库将它们存储在用户主目录中的单个文件中。通过添加 kb.encryption 块并提供密钥，可启用可选的静态加密：

{
  "kb": {
    "encryption": { "enabled": true, "key_file": "~/.config/infobroker/kb.key" }
  }
}

密钥文件（明文，0600 权限）是跨 MCP 客户端和操作系统最可靠的来源；INFOBROKER_KB_KEY（32 字节密钥）或 INFOBROKER_KB_PASSPHRASE（口令短语）也可用。使用 openssl rand -base64 32 生成密钥。加密保护存储和磁盘保存的报告，防止任何在无密钥情况下获取文件的人访问——设备失窃、备份或云同步泄露、其他本地账户。它不保护同一台机器上的恶意 MCP 客户端或恶意软件，这些由全盘加密覆盖。

两条规则确保安全。第一，加密是你主动选择的：如果密钥缺失或错误，知识库会锁定并报告错误，而不是触碰你的数据——因此请备份密钥（忘记密钥或口令短语意味着存储按设计不可恢复）。第二，服务器从不写入部分文件：每次保存都是原子的，无法识别或更新版本的存储格式永远不会被覆盖。

kb 工具的 encryption 操作是这一过程的日常界面，它从不回显机密材料——generate_key 和 backup 返回文件路径，rekey 读取密钥文件而非原始密钥。

启用：生成密钥、备份密钥、添加 kb.encryption 块并重新加载；存储立即就地加密。禁用：移除该块并重新加载；存储立即解密为明文（过渡期间请保留密钥，以便服务器能读取存储以解密）。恢复锁定的存储：使用 status 查看状态，verify 在提交前确认候选密钥，backup 恢复密钥文件的副本，rekey 在不丢失内容的情况下切换到新密钥。重新加密后，将 kb.encryption.key_file 指向新密钥，重新加载，然后再次运行 verify 以确认新密钥能打开存储。

infobroker_kb action=encryption operation=generate_key key_file=~/.config/infobroker/kb.key
infobroker_kb action=encryption operation=backup    key_file=~/.backup/kb.key.bak
infobroker_reload_config

在重新加载前将 kb.encryption 块添加到 config.local.json 以启用，或在重新加载前移除它以禁用。当存储被锁定时，status、verify 和 rekey 仍然可用，因此你无需先解锁即可恢复。

自带端点

任何 HTTP 搜索端点都可以成为 Infobroker 提供商，无需改动源码树。在 config.local.json 中将其声明为 generic_http 提供商，然后从调度链中引用它：

{
  "providers": {
    "my_search": {
      "tier": "generic_http",
      "capabilities": ["web_search"],
      "enabled": true,
      "priority": 20,
      "endpoint": "https://api.example.com/search",
      "query_param": "q",
      "results_path": "data.items",
      "field_map": { "title": "name", "url": "link", "snippet": "summary" }
    }
  },
  "dispatch": { "general_web": ["my_search", "duckduckgo"] }
}

服务器 GET endpoint?query_param=<query>，遍历 results_path（以点分隔进入响应 JSON），并使用 field_map 将每个结果映射到通用形态。将 slug 添加到你的 config.local.json 覆盖项中并调用 reload_config 即可立即使用。

按提供商的状态和来源

两个可选键用于微调 config.json 中按提供商的行为：

• degraded_latency_ms —— 近期平均延迟超过此毫秒数的提供商，即使可达，也会被 providers 健康操作报告为 degraded。全局的 output.degraded_latency_ms 在提供商未设置自身值时作为回退。

• resells —— 对聚合器/转售后端（展示其他发布者页面的搜索引擎，如 DuckDuckGo、Brave 或 SearXNG）设置为 true。服务器在底层 API 暴露时报告每个结果的 original_source（例如 Brave 的 profile 名称）；第一方来源（Wikipedia、arXiv）将其留空，因为页面本身就是源头。

对比

其他每个搜索 MCP 服务器都要求你选择一个提供商并信任它。 Infobroker 给你一支舰队——并为每项任务挑选合适的那个。 当某个提供商失败时，下一个会无缝接管，你毫无察觉。 当某个论断至关重要时，交叉验证引擎会找出共识、 矛盾和缺口。内置技能将研究闭环推进到成品写作。 一个服务器。所有来源。真正交付的研究。

最后更新：2026-08-24。

参与贡献

• Node.js 20+。 运行 node --version。从 nodejs.org 获取。

• npm install && npm run typecheck

• 在 skills/ 中打包你自己的技能，以扩展研究流水线。

• 验证 README 结构：npm run validate-readme

• 版本管理： CalVer（YYYY.MM.DD）。npm run version-bump 会将 今天的日期写入所有版本引用。预提交钩子验证 一致性。npm run push 负责检查、打标签并推送。

• MCP 协议：modelcontextprotocol.io

• 提供商：DuckDuckGo · Jina Reader · Wikipedia API

规范来源：git.gay/flukeatzerocool/Infobroker。此 GitHub 仓库为只读镜像。

许可证

MIT。可自由使用、修改和再分发。内置的客户端技能和 指令文件以相同许可证发布，因此完整的研究流水线 ——服务器、技能和文档——均可自由用于商业和 开源项目。第三方提供商仍受其自身条款和 API 密钥约束。

规范

服务器由单一源规范 infobroker.md （v2026.08.24）构建，该规范定义了每项需求及验证它的关卡。 每项需求都追溯到实现文件，npm run check 将代码、规范和本 README 进行对账，确保文档所写的 正是服务器实际交付的。