CiteWire

[ [ [

citewire.org · [Openly Use](https://openly use.org)

面向新闻和研究发现的，以署名优先的 MCP 基础设施。

CiteWire 为智能体提供结构化、只读的新闻和元数据访问，同时为原始发布者保留署名和流量。它可以，兼容的新闻" 具化为类型化的 MCP 工具，查询可选的公共提供商 API，或在同一个服务器中同时做到两者。

Community 版可以独立使用。它包含 MCP 核心、stdio 和 HTTP 传输、通用平台适配器，以及本仓库内以 MIT 许可发布的全部提供方适配器。商业产品方向是附加的，各地集中在主运行管理、个性化、工作流、协作、历史和运维支持。参见：产品层级](docs/product-tiers.md)。

CiteWire 的用途

• 新闻平台运营者 可以通过 news.list、news.get、news.topics 和 news.about 暴露只读 API。

• 研究者和智能体构建者 可以只启用他们需要查询的公共新闻与研究提供方。

• 自主托管者 可以在 stdio、无状态 HTTP 或 Node 无服务器函数中运行同一个服务器。

• 提供方贡献者 可以增加一个高度聚焦的适配器，而不引入任何运行时依赖。

CiteWire 不是全文采集服务、爬虫、发布者、编辑系统或权利清理服务。它不存储或转发文章正文。提供方的可达性不能替代你对提供方当前条款的审阅，尤其针对你自身使用场景。

Related MCP server: agentpulse-mcp

快速开始

要求：Node.js 18 或更高版本。Community 是仅 ESM 的 Node 包，不提供 CommonJS 入口。

创建 citewire.config.json，启用一个 provider：

{
  "providers": {
    "openalex": { "enabled": true }
  }
}

通过 stdio 运行服务器：

npx -y citewire --config citewire.config.json

stdio 是默认传输，也是 MCP 客户端将 CiteWire 作为本地进程启动常用的方式。

MCP 客户端配置

请使用绝对配置路径，因为客户端可能不总是从项目目录启动：

{
  "mcpServers": {
    "citewire": {
      "command": "npx",
      "args": [
        "-y",
        "citewire",
        "--config",
        "/absolute/path/to/citewire.config.json"
      ]
    }
  }
}

HTTP 传输

在 8722 端口运行无状态 HTTP 传输：

npx -y citewire --config citewire.config.json --http 8722

本地端点通过 POST / 接受 JSON-PC，不提供会话或事件流。

两种使用方式

1. 封装兼容的新闻平台

声明一个有显示名、站点 URL 和只读 API base 地址：

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  }
}

这个配置暴露四个工具：

所需的 HTTP 接口在平台读取 API 合约文档中定义：平台读 API 合约。

2. 启用公共提供方工具

提供方适配器已包含在 Community 中，默认禁用。某个提供方只会在配置项其设置 enabled 为 true 时被激活。

{
  "providers": {
    "gdelt-doc": { "enabled": true },
    "arxiv": { "enabled": true },
    "crossref": {
      "enabled": true,
      "mailto": "operator@example.com"
    }
  }
}

Crossref 需要部署者自己的联系邮件地址请求能识别到自由量池。citewire 只会在 mailto 参数和 User-Agent 中把该地址发送给 Crossref。不要复制示例地址。

当前适配器：

在启用一个提供方前，请先阅读 Providers。其中记录了各适配器的端点、官方文档、免费使用基础和礼貌限制。读者应以提供方自己的文档为最终权威。

配置行为

• platform 是可选的。

• providers 是可选的。

• 配置中未出现的提供方保持禁用。

• 空配置有效，且不暴露任何工具。

• 无效配置会在启动时失败，并带错误中的字段信息。

• tools/list 是运行部署的权威工具列表，因为启用的工具取决于该部署的配置。

可以将平台与提供方工具结合：

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  },
  "providers": {
    "openalex": { "enabled": true }
  }
}

可选的 Community 政策基础

CiteWire 可提供基础的来源、权利和影子评估，所有 read-only：

{
  "community": {
    "enabled": true,
    "classifierMode": "shadow",
    "thresholds": {
      "adjacent_min": 0.5,
      "standard_min": 0.6
    }
  }
}

所有捆绑源默认关闭。此项配置不会进行任何网络呼叫，不加载任何凭据，也无法发布任何内容。配合凭据的权利检查会在内存中接受不透明的引用，但不会返回该引用。分类器被强制为影子模式，在所有新审阅系统出现以前，一律报告 publishable: false。

更详细的内容、失败策略、标准MCP工具与资源，以及当前限制，请读取来源注册库与权利文档。

设计边界

• MIT and zero dependency. 此包使用 Node 的内置模块，无任何第三方依赖。

• Node ESM. Community 支持 Node 18+ 且仅 ESM，不提供 CommonJS 入口或构建。

• 只读。 include 不写任何外部或提供方的内容，只读取。

• 无状态。 没有账户、会话、保存搜索或历史。

• 署名优先。 从，它会保存来源方的元数据和链接。

• 配置驱动。 运行者决定哪些工具开启，不活动的不自动触发。

• 零存储。 不保留平台、或研究元数据。

这些设计边界在治理政策中有系统性说明：项目治理政策。

生态、标准与产品文档

• 产品层级

• 部署/发行

• 治理

• 提供方

• 平台合约

• 贡献者

• 发布

• 支持、安全、行为准则

这些文档覆盖了稳定维护边界，也明确额外的商业形态。

项目本源

CiteWire 源于首次部署、用于 Karaya Group Industry News 的样子。公共平台合约是通用，可以 套用更多新闻 API。

Contributing

运行 npm test 进行测试。无需额外安装。在给一个 provider 或改动一个公共 API 前，请先阅读 CONTRAG.md。

许可证

Community 使用 MIT 许可证，详见 license。