FBI犯罪数据MCP服务器
  
MCP（模型上下文协议）服务器，提供对 FBI犯罪数据浏览器 API.
直接从任何兼容MCP的客户端查询犯罪统计数据、逮捕数据、仇恨犯罪、NIBRS事件、执法就业等。
特性
- 17工具 涵盖广泛的犯罪数据主题
- 犯罪趋势和汇总报告系统（SRS）犯罪数据 - 国家事故报告系统（NIBRS）基于事故的数据和国家估计 - 按人口统计的逮捕统计数据 - 基于偏见动机的仇恨犯罪事件 - 扩大凶杀和财产犯罪细节 - 警察雇佣、执法人员被杀和袭击（LEOKA）、执法自杀数据收集（LESDC）和使用武力 - 机构查找、参考数据、缓存管理和溢出读取
- 三个查询级别 --国家、州和机构——具有自动参数验证功能
- 智能年度汇总 -每月API数据自动汇总为年度总数（计数的总和、费率的平均值、人口的最后值），并可选择每月粒度
- 分层磁盘备份缓存 --稳定数据（趋势、参考、摘要）的生存时间（TTL）为90天，动态数据（事件、逮捕、机构查找）为30天
- 溢出物处理 --超过128K个字符的响应会保存到磁盘并返回预览，因此大型查询永远不会被静默截断
- 输入验证 --日期格式/顺序检查、违规和偏见代码验证以及基于级别的参数要求，并带有明确的错误消息
- 滑动窗口速率限制 --1000个请求/小时，透明的等待时间反馈
- 参考工具 用于机构查找（按州、发起机构标识符（ORI）或具有名称过滤的地区）和代码翻译
快速开始
- 获取免费的API密钥 从 api.data.gov
- 使用Claude Desktop运行 --添加到您的
claude_desktop_config.json:
{
"mcpServers": {
"fbi-crime-data": {
"command": "uvx",
"args": ["fbi-crime-data-mcp"],
"env": {
"FBI_API_KEY": "your-api-key-here"
}
}
}
}- 或者直接运行：
FBI_API_KEY=your-key uvx fbi-crime-data-mcp可用工具（17）
核心犯罪数据
| 工具 | 说明 |
|---|---|
get_summarized_crime_data | SRS犯罪数据——比率、实际值、暴力犯罪、财产犯罪、凶杀、强奸、抢劫、袭击、入室盗窃、盗窃、机动车盗窃、纵火 |
get_nibrs_data | 70多种犯罪类型的NIBRS事件数据 |
get_arrest_data | 按罪行分列的逮捕统计数据，并可选择人口统计数据（性别、种族） |
get_crime_trends | 10种犯罪类型的全国犯罪趋势百分比变化 |
get_nibrs_estimation | NIBRS按州、地区、机构类型或人口规模进行的全国估计 |
专业犯罪数据
| 工具 | 说明 |
|---|---|
get_hate_crime_data | 按偏见动机分类的仇恨犯罪事件（30+类） |
get_expanded_homicide_data | 补充凶杀案报告----受害者/罪犯人口统计、武器、情况 |
get_expanded_property_data | 扩大财产犯罪详细信息——入室盗窃、盗窃、机动车盗窃（MVT）、抢劫的被盗/追回价值 |
执法数据
| 工具 | 说明 |
|---|---|
get_police_employment | 按性别分列的干事和文职雇员人数，每1 000人的比率 |
get_leoka_data | 被杀害和袭击的警察——武器、环境、人口统计 |
get_lesdc_data | 执法自杀数据——人口统计、种族、职务状况等 |
get_use_of_force_data | 导致死亡、重伤或开枪的使用武力事件 |
概述
| 工具 | 说明 |
|---|---|
get_cde_homepage_summary | CDE主页摘要——使命宣言、导航、数据新鲜度、日期范围和国家犯罪趋势 |
参考和查找
| 工具 | 说明 |
|---|---|
lookup_agency | 按州、ORI代码或司法区查找执法机构 |
get_reference_data | 状态列表、犯罪/偏见代码查找、数据刷新日期 |
manage_cache | 查看缓存统计信息、清除所有条目或仅清除过期条目 |
read_spillover | 读取工具响应超过大小限制时保存的溢出文件 |
大量响应
当工具响应超过128000个字符时，完整结果将保存到 ~/.cache/fbi-crime-data-mcp/spillover/ 并返回带有文件路径的截断预览。为了避免这种情况，请缩小查询范围（缩短日期范围，指定州/机构）。
数据源
所有数据均来自FBI 犯罪数据浏览器 API，提供统一犯罪报告（UCR）数据，包括简易报告系统（SRS）和基于国家事件的报告系统（NIBRS）。
API费率限制
- 注册密钥：每小时1000个请求（滚动窗口）
- DEMO_KEY：每IP每小时30个请求
服务器包括一个内置的速率限制器（1000 req/hr）。DEMO_KEY限制是在API侧强制执行的。
发展
# Install dependencies
uv sync
# Run the server locally
FBI_API_KEY=your-key uv run fbi-crime-data-mcp
# Run tests
uv run pytest许可证
麻省理工学院