Police Shootings

@pipeworx/police-shootings

2015年以降の米国における警察による致命的な銃撃事件 — The Washington Post の Fatal Force データベースからリアルタイムでプロキシする、集計件数、個別の事件記録（公開されている被害者の氏名を含む）、および機関別の内訳です。

Pipeworx の一部です — AI エージェントを1784以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとの提携、同社による推奨または公開を受けたものではありません。

ツール

• police_shootings_summary(group_by?, state?, year?) — 集計件数 （州、年、人種、武装状況、脅威の種類、性別、精神疾患の有無、または ボディカメラの有無別）。氏名は返しません。
• police_shootings(state?, city?, year?, armed_with?, race?, limit?, offset?) — 被害者の氏名を含む個別の事件記録です。 デフォルトでは少数（limit 25、最大200）を返します。応答が切り詰められた場合は truncated:true、total_matching、および絞り込みのヒントが含まれます。
• agency_shootings(agency, state?) — 1つの法執行機関による 致命的な銃撃事件の件数と、年／人種／武装状況別の内訳です。機関名の一部で検索し、 複数の機関が一致した場合は推測で選ばず、候補を少数返します。

認証

キーは不要です。上流データは登録、キー、ログインが不要な公開CSVです。

データソース

• The Washington Post、Fatal Force データベース — 2015年1月1日以降に米国で発生した、勤務中の警察官による致命的な銃撃事件、および関係した法執行機関の一覧です。Attribution-NonCommercial-ShareAlike 4.0 International（CC BY-NC-SA 4.0）の下で公開されています。データとともに利用条件が伝わるよう、すべてのツール応答に license と attribution フィールドが含まれます。このパックはライブプロキシです — キャッシュミスごとに Post が公開するファイルを最新の状態で取得し（通常のクライアントと同じく、エッジキャッシュの有効期間は6時間）、データセットをこのリポジトリにコミットすることはありません（CLAUDE.md の「mirror-needs-grant-proxy-does-not」：リクエストごとのプロキシ呼び出しは再配布ではありませんが、データセットの一括コピーは再配布にあたり、ライセンスで禁止されています）。人間向けのページ： https://www.washingtonpost.com/graphics/investigations/police-shootings-database/. ルートは src/index.ts にのみ定義されています。

注意事項

• Post 自身のREADMEには、データは「定期的に更新される」と記載されていますが、このパックが読み込む公開ファイルは現在、2024-12-31までのデータで終わっています（2026-10-13にライブで確認済み）。プロキシ可能なそれ以降のデータはありません。各応答の data_as_of / dataset_coverage.max_date は固定の主張ではなく、呼び出し時点で Post が実際に公開しているデータを反映します。
• Post が追跡しているのは、Michael Brown 事件に類似する勤務中の警察官による銃撃事件のみです — 拘留中の死亡、勤務時間外の銃撃、銃撃以外による死亡は対象外です。この範囲を超えて包括的なデータではありません（Post 自身も、報告が追いつく前は過少計上の可能性があると述べています）。
• race と armed_with には、事件ごとに複数の値が含まれる場合があり、ソースではセミコロン区切りで記録されています（例："W;B"、"gun;knife"）。police_shootings / police_shootings_summary の race および armed_with フィルターは、セミコロンで区切られた値のいずれかに、指定値が一致すれば該当します。
• 事件の agency_ids には、複数の部署が関与した場合、複数の機関が記載されることがあります（セミコロン区切り）。 agency_shootings はこの一覧を使って結合します。
• 氏名、年齢、その他の個人単位のフィールドは、Post の公開内容とまったく同じ形で提供されます — 追加、推測、または他の人物データソースとの結合は行いません。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "police-shootings": {
      "url": "https://gateway.pipeworx.io/police-shootings/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/police-shootings/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共通ツールが約 30 個一覧表示されます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認する際の正式な情報となります。

これは意図的な仕様であり、誤って多重化されているわけではありません。メタツールを使うと、このパックでは扱えない質問にも、カタログ全体を横断する ask_pipeworx 経由で回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントに接続するのではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1784 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、すべてのツールに ask_pipeworx でアクセスできます。

MCP クライアントをお持ちでない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/police_shootings_summary \
  -H 'Content-Type: application/json' \
  -d '{"group_by":"year"}'

最初の呼び出しにアカウントは不要です。ツールの内容を確認するには、GET https://gateway.pipeworx.io/v1/tools/police_shootings_summary を使います。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイ経由の通信も必要ありません。

{
  "mcpServers": {
    "police-shootings": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-police-shootings"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-police-shootings

stdin/stdout 経由で MCP と通信し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。ソースもツールも同じですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Police Shootings data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT