local-dfw-mcp

local-dfw-mcp

为你的 AI 提供达拉斯–沃思堡本地指南。 这是一个开源的 MCP 服务，可将 Claude（或任何 MCP 客户端）连接到官方的市、县、州和联邦数据，让你可以询问：

• 🎪 “Frisco 这周末有什么活动？”
• 🌊 “1500 Marilla St 是否位于洪水区？”
• 🏫 “Garland 附近的学校评级如何？”
• 🚰 “这个地址的供水和污水处理服务由谁提供？”
• 🕳️ “我这条街上有人报告坑洞或非法倾倒垃圾吗？”
• ⛈️ “Dallas 目前有恶劣天气警报吗？”
• 🏠 “根据县里的记录，这栋房子的评估价是多少？”

每个答案都来自权威公共来源，并附有官方记录链接。无需 API 密钥——一个可选的免费密钥即可解锁演唱会和体育活动（见下文）。

快速开始

将以下内容添加到你的 MCP 客户端配置中（Claude Desktop、Claude Code 等）：

{
  "mcpServers": {
    "local-dfw": {
      "command": "npx",
      "args": ["-y", "local-dfw-mcp"]
    }
  }
}

需要 Node ≥ 20。就这么简单——重启客户端，然后开始提问。

你可以询问什么

工具	覆盖范围	可回答的问题
dfw_events	见下文	正在举办什么活动：官方城市日历，以及通过免费的 Ticketmaster 密钥查询演唱会／体育活动／戏剧演出
dfw_311	仅限 City of Dallas	按地址／类型／状态查询 311 服务请求
dfw_crime	City of Dallas（默认）、Fort Worth（city: "fortworth"）或 Denton（city: "denton"）	按（街区级）地址／违法行为查询警方事件
dfw_permits	Fort Worth（默认）、McKinney（city: "mckinney"，需要 address）或 Arlington（city: "arlington"）	按街道名称（加门牌号）或地址、类型、状态查询建筑／开发许可证
dfw_code_cases	Fort Worth（默认）、McKinney（city: "mckinney"）或 Arlington（city: "arlington"）	按地址或投诉类型查询法规合规违规事项（物业维护、高草、分区等）
dfw_traffic	见下文	实时事件（Fort Worth）、街道／车道封闭信息（Dallas + Arlington，合并并标注城市），TxDOT 年度交通流量统计 + 建设项目（4 个核心县）
dfw_fema_flood	全国	FEMA 洪水区信息 + 通俗易懂的保险解读
dfw_tea_schools	Texas	按校区／学区／县查询公立学校 + TEA A–F 评级（2022-23）
dfw_nws_alerts	全国	DFW 指定地点当前有效的 NWS 天气警报
dfw_utility_providers	Texas	查询某个地址的供水／污水处理服务提供方（PUC CCN）
dfw_district_lookup	DFW	查询某个地址所属的县、City-of-Dallas 市议会选区及代表、ISD
dfw_appraisal	Texas（已核实 4 个核心县）	按地址查询县评估记录：业主、土地／改良物／市场价值（2025 年认证税册）、建成年份、土地用途、英亩数
dfw_health	—	检查每个上游服务，并报告各来源状态
about	—	版本、覆盖范围、许可证、来源信息

活动覆盖范围一览

来源	城市／范围	是否需要密钥
官方城市日历	Dallas（仅限 Parks & Recreation 日历——没有全市范围的 Dallas 信息源）、Garland、Frisco、Mesquite、McKinney	不需要
Ticketmaster（演唱会、体育活动、戏剧演出）	整个都会区	需要免费密钥，见下文

Plano、Arlington、Fort Worth、Irving 和其他郊区目前没有发布可用的日历信息源——工具会说明“未覆盖”，而不是猜测。

工具如何串联

目前还没有组合式的“房产报告”工具——也不需要。 这些工具共享自然连接键：地址、纬度/经度、地块、议会选区和 ISD，因此你的 AI 可以围绕一个问题在这些工具间查询：

• 准备搬进一栋房子 — dfw_appraisal（房子值多少钱、业主是谁）→ dfw_fema_flood（洪水区 + 保险）→ dfw_district_lookup（县、议会选区、ISD）→ dfw_tea_schools（评估该 ISD 的校区）→ dfw_crime（附近的事件）→ dfw_utility_providers（水务/污水服务该联系谁）。
• 关注街区开发情况 — dfw_permits（正在建什么）→ dfw_code_cases（同一地址的违规情况）→ dfw_311（邻居在报告什么）。
• 规划周末活动 — dfw_events（有什么活动）→ dfw_traffic（沿途的事件和封路情况）→ dfw_nws_alerts（值得了解的天气信息）。

提出组合问题（“我们在考虑买 Frisco 附近的房子——查查学校、洪水风险和评估价”），有能力的客户端就会自行串联查询。

可选设置

所有功能开箱即用。两个免费密钥可解锁更多功能：

环境变量	解锁的功能
DFW_TICKETMASTER_API_KEY	dfw_events 中的演唱会、体育赛事和戏剧演出。免费（每天 5000 次调用）：https://developer.ticketmaster.com
DFW_SODA_APP_TOKEN	提高 Dallas 开放数据查询的速率限制（在共享/企业网络上很有帮助）。免费：https://dev.socrata.com/register

高级配置项

环境变量	用途
DFW_LIMIT_<SOURCE>	覆盖每个上游来源的并发上限（SODA、ARCGIS、FEMA、CENSUS、NWS）
LOCAL_DFW_MCP_TIER	core 或 all——为工具数量受限的客户端精简工具列表
DFW_CACHE_DISABLED	设为 1 可禁用进程内缓存（测试使用）

不收集遥测数据。服务只读取 resources/datasets-index.md 中列出的公共数据源，不会写入任何数据。

以诚信为设计原则

• 防止误用其他城市的数据。 邮政地址中的“Dallas, TX”不等同于 Dallas 市辖区。城市范围限定的工具会验证地址（邮编/关键词 → 地理编码 → 市界多边形），并明确提示“未覆盖”，而不是悄悄返回看似合理、实则来自其他城市的数据。
• 不使用过时数据。 数据源在发布前都会经过实时验证——这就是为什么 dfw_permits 和 dfw_code_cases 仅覆盖 Fort Worth、McKinney 和 Arlington：Dallas 当前的所有许可数据源都已过时约 20 个月；Dallas 的违章案件发布也于 2025-01-31 停滞，因此两者都未接入 Dallas 的数据。Irving 的整个开放数据管道（许可、违规、警方事件、活动）约在 2025-02-28 停摆或受到机器人访问限制，因此也未接入。其他待支持的数据还包括 Fort Worth/McKinney/Arlington/Denton/Dallas 以外的郊区门户，以及组合式 dfw_property_360。详情见 resources/datasets-index.md。
• 在数据源处核实。 每条响应都包含指向官方记录的 source_url。

重要声明

• 不是消费者报告。 不得将 dfw_crime、dfw_code_cases、dfw_appraisal（以及本 MCP 整体）用于租户筛查、就业筛查、信贷、保险，或《公平信用报告法》监管的任何其他用途。上游会将犯罪地址取整到街区级别，以保护隐私。dfw_appraisal 中的业主姓名和估值是公开记录，但不得用于筛查；它报告的是 2025 年认证评估价值，不是税单金额。
• 提示词注入。 311 描述、活动列表及类似的上游自由文本由公众撰写，并会进入你的大模型上下文。此服务会将它们呈现为引用文本/表格数据，但应将上游数据中出现的任何指令视为数据，而不是命令。

许可证与来源

Apache-2.0。请参阅 LICENSE 和 NOTICE。

核心基础代码（lib/）移植自 Ed Neuhaus / Neuhaus Realty Group LLC 的 local-austin-mcp（Apache-2.0）——这是构建城市级民生 MCP 的优秀模板。每个移植的文件都包含注明变更的署名声明。所有 DFW 数据源、都会区路由器以及工具本身均为全新开发。