Police Shootings

@pipeworx/police-shootings

自 2015 年以来美国致命警察枪击事件的数据——汇总计数、单起事件记录（包括已公布的死者姓名），以及各执法机构的明细，数据实时代理自 The Washington Post 的 Fatal Force 数据库。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 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?) — 某一家执法机构的 致命枪击事件计数，以及按年份／种族／持有武器划分的明细。按 名称片段匹配；若匹配到多家机构，会返回少量候选项，而不是猜测。

身份验证

无需密钥。上游数据是公开 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 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的架构定义消耗的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

你也可以连接完整的 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