CiteWire

citewire.org · Openly Useful

出典を最優先する、ニュースと研究の発見のための MCP インフラストラクチャ。

CiteWire は、元のパブリッシャーへのクレジットとトラフィックを保持しながら、ニュースおよび研究メタデータへの構造化された読み取り専用アクセスをエージェントに提供します。互換性のあるニュースプラットフォームを型付き MCP ツールとして公開したり、オプションのパブリックプロバイダー API を照会したり、1つのサーバーでその両方を行うこともできます。

Community エディションは単体でも有用です。MCP コア、stdio および HTTP トランスポート、汎用プラットフォームアダプター、およびこのリポジトリ内のすべてのプロバイダーアダプターを、MIT ライセンスの下で含みます。商用製品の方向性は付加的であり、マネージド運用、パーソナライゼーション、ワークフロー、コラボレーション、履歴の保持、サポートに重点を置いています。製品ティアを参照してください。

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 を、プロバイダーを 1 つだけ有効にして作成します：

{
  "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-RPC を受け入れます。セッションやイベントストリームは提供しません。

2つの利用の仕方

1. 互換性のあるニュースプラットフォームをラップする

表示名、サイト管理 URL、読み取り API ベースを指定してプラットフォームを宣言します：

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

この設定で4つのツールが公開されます：

必要な HTTP サーフェスは、プラットフォーム読み取り API の契約に文書化されていますドキュメント詳細。

2. パブリックプロバイダーのツールを有効にする

プロバイダーアダプターは Community に含まれており、デフォルトでは無効です。プロバイダーが有効になるのは、設定エントリの enabled が true の場合のみです。

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

Crossref は、デプロイヤー自身の連絡先メールを必須とします。これにより、Crossref のポライトプール内で運用者を識別できます。citewire はそのアドレスを、リクエストの mailto パラメーターと User-Agent でのみ Crossref に送信します。この例のアドレスをコピーしないでください。

現在のアダプターは次のとおりです：

Atomic なーター を有効化する前に 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
    }
  }
}

バンドルされているすべてのソースはデフォルトで無効のままです。この設定はネットワーク呼び出しを行わず、認証情報を取得せず、公開も行いません。認証情報に基づく権利チェックは、不透明なシークレットマネージャルトークンをメモリ内で受け取ることができますが、それらの参照。分類器はシャドウモードに固定されており、別途レビューされた編集システムと評価コーパスが存在するまで、常に publishable: false を返します。

ランテム検証、フェールクローズポリシー、標準的な MCP ツールとリソース、現在の制限については、ソースレジストリと権利 を参照してください。

設計上の境界

• MIT かつ依存ゼロ このパッケージは Node.js じょうの組み込みのみを使用し、ランメンテ依存または開発依存はありません。

• Node.js ESM Community は Node.js 18 以降を ESM でサポートします。CommonJS との互換性も CommonJS ビルドも提供しません。

• 読み取り専用 含まれるツールは、プラットフォームおよびプロバイダーの読み取り表面に対してクエリを行います。

• ステートレス Community サーバーには、アカウント、セッション、保存された検索、履歴の保持はありません。

• 帰属優先 結果には、上流プラットフォームまたはプロバイダーから提供されるソースメタデータとリンクが保持されます。

• 設定値駆動 どのツールが存在するかはデプロイヤーが決定します。何か人自己制御で有効になることはありません。

• ストレージなし コアはプロバイダーのレスポンスやソースコンテンツを保持しません。

これらの境界は、ガバナンスポリシーによって維持されています。

エコシステムと製品ドキュメント

• プロダクトティア は、恒久的な Community の価値と、追加される商用上の利用グループを定義します。

• ディストリビューション には、正確なレジストリとカタログのチェックリストが含まれています。未実施の提出は PENDING とマークされます。

• ガバナンス は、意思決定、プロバイダーの管理、互換性、ライセンスを説明します。

• Providers は、各上流プロバイダーを説明します。

• プラットフォーム条項 は、互換性のあるニュース読み取り API を定義します。

• コントリビューティング は、セットアップ、テスト、プロバイダーの追加、プルリクエストの期待事項を説明します。

• リリース は、パッケージ、レジストリ、リリース管理者の遵守事項を定義します。

• サポート, セキュリティ, 行動規範 は、コミュニティの運用手順を定義します。

プロジェクト由来

citewire は、最初のデプロイメントである Karaya Group Industry News によって形成されました。パブリックプラットフォーム契約はプロバイダに依存せず、互換性のあるすべての読み取り API をラップできます。

コントリビューション

テストスイートは npm test で実行します。インストール手順は必要ありません。プロバイダーの提案や公開契約の変更を行う前に、CONTRIBUTING.md を参照してください。

ライセンス

Community は MIT ライセンスです。LICENSE を参照してください。