CiteWire

citewire.org · Openly Useful

MCP-инфраструктура с приоритетом атрибуции для поиска новостей и исследовательских материалов.

CiteWire предоставляет агентам структурированный, доступный только для чтения доступ к метаданным новостей и исследований, сохраняя атрибуцию и трафик для исходного издателя. Он может предоставлять совместимую новостную платформу в виде типизированных MCP-инструментов, опрашивать необязательные публичные API провайдеров или делать и то и другое в одном сервере.

Community-версия полезна сама по себе. Она включает МCP-ядро, транспорты stdio и HTTP, универсальный адаптер платформы и все адаптеры провайдеров из этого репозитория под лицензией MIT. Коммерческое направление продукта аддитивно и сосредоточено на управляемых операциях, персонализации, рабочих процессах, совместной работе, сохранённой истории и поддержке. См. Уровни продукта.

Назначение CiteWire

• Операторы новостных платформ могут предоставить совместимый read-API через news.list, news.get, news.topics и news.about.

• Исследователи и разработчики агентов могут включать только те публичные новостные и исследовательские провайдеров, к которым они хотят обращаться.

• Селфхост-пользователи могут запускать один и тот же сервер через stdio, stateless HTTP или внутри бессерверной функции Node.js.

• Контрибьюторы провайдеров могут добавить узконаправленный адаптер без добавления зависимости времени выполнения.

CiteWire — это не сервис полнотекстового поглощения, паук, издательская система, редакционная система или служба оформления прав. Он не хранит и не персонализирует тексты статей. Доступность провайдеров не заменяет самостоятельного изучения текущих условий конкретного провайдера для вашего сценария использования.

Related MCP server: agentpulse-mcp

Как asymmetric добиться.

Требования: Node.js 18 или новее. Community — это сторонний npm-пакет с поддержкой только ESM; CommonJS-точка входа не предоставляется.

Создайте вручную и укажите citewire.config.json с одним включённым провайдером:

{
  "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

Запустите stateless-транспорт HTTP на порту 8722:

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

Локальная конденцпинация принимает JSON-RPC через POST /. У неё нет помещений или потоков событий.

Два способа использования

Ответ:

1. Интеграция с совместимой новостной платформой

Объявите платформу с отображаемым названием, site и базовым адресом read-API:

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

Такая настройка предоставляет четыре инструмента:

Обязательная HTTP-поверхность описана в контракте API платформ (read-API).

2. Включение публичных инструментов провайдеров

Адаптеры провайдеров включены в состав Community и по умолчанию выключены. Провайдер становится активным только после того, как в его конфигурации enabled установлено в true.

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

Для Crossref требуется собственный контактный email разворачивающего оператора, чтобы запросы определяли оператора в его вежливом пулепользователей. CiteWire отправляет этот адрес в только Crossref в параметре mailto запроса и в User-Agent. Не копируйте адрес из примера.

Действительные адаптеры на данный момент:

Before enabling a provider, read 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 может предоставлять локальную, только для чтения основу для политики источников, оценки прав и теневого скоринга включения:

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

Каждый поставляемый источник по умолчанию остаётся отключён. У всех таких расширений нет или они не персонализированы. Checks on оснduction, they don't call the network. We didn't see credentials. Settings могут не позволять публиковать и не вызывать сеть. Проверки тариф на основании учётных данных принимают непрозрачные ссылки на менеджер секретов в памяти, но никогда не возвращают такие ссылки. Классификатор принудительно работает в теневом режиме и всегда выдаёт publishable: false, пока не появится независимо рецензируемая редакционная система и корпус для оценки этого сужения.

Подробнее смотрите Source registry and rights в вопросе проверки в runtime, политику fail-closed, канонических инструментов и работоспособности серверных MCP, а также ограничения.

Границы проекта

• MIT и вариант без зависимостей. Пакет использует встроенные модули Node.js и не имеет зависимостей в runtime или времени разработки.

• Node ESM. Community поддерживает Node.js 18 или новее через ESM. Переменной поддержки входной точки для CommonJS нет.

• Только чтение. Все входящие инструменты читают данные с платформ и провайдеров.

• Отсутствие состояния. Сервер Community не имеет учётных записей (Read-only), сесс и не сохраняет поисковые запросы и события.

• Атрибуция прежде всего. Результаты сохраняют метаданные и ссылки, полученные от статьистей.

• Управление через конфигурацию. Деployer решает, какие инструменты будут доступны; именно он их включает.

• Без встроенного хранилища. Ядро не сохраняет ответы и не сохраняет содержимое источников.

Эти ограничения сохраняются через политику проекта.

Экосистема и документация продукта

• Product tiers определяет постоянную ценность Community и границу дополнительного коммерческого направления.

• Distribution и распределения пакетов содержат точный перечень проверок регистрации. Ниже в таблицах параметры PENDING для тех, которые не были произно.

• Governance объясняет решения соuncil, владение инструментами в MCP, совместимость и лицензирование.

• Providers детали описывает каждая адаптеры провайдеров.

• Platform contract определяет совместимый с ним API чтения новостей.

• Contributing описывает настройку, тесты, добавление провайдеров и условия pull requests.

• Releasing определяет порядок выпуска и реестровборов пакетов.

• Support, Security и Code of Conduct задают каналы взаимодействия сообщества.

Происхождение проекта

CiteWire был разработан в ходе его первого производственного использования для Karaya Group Industry News по адресу. Публичный контракт платформы остаётся общим и позволяет обернуть любой совместимый read-API.

Как помочь проекту

Запустить набор тестов: npm test. Установка не требуется. Ознакомьтесь с CONTRIBUTING.md перед предложением нового провайдера или изменения открытого контракта.

Лицензия

Community распространяется по лицензии MIT. См. LICENSE.