Open Balt MCP

巴尔的摩许可证MCP服务器

MCP（模型上下文协议）服务器，提供对巴尔的摩市住房和建筑许可证数据的访问 巴尔的摩开放数据门户.

特性

此MCP服务器提供查询巴尔的摩建筑许可证数据库的工具：

• 按地址搜索：查找特定地址或地址模式的许可证
• 按日期范围搜索：在指定日期范围内获得许可证
• 按邻居搜索：查找特定街区的所有许可证
• 按案例编号搜索：按案件编号查找特定许可证
• 最近的许可证：获取最近颁发的许可证
• 计数许可证：计数允许符合特定条件

安装

1. 安装Python 3.10或更高版本（建议使用Python 3.11）：

   brew install python@3.11

1. 安装依赖项：

   pip3.11 install -r requirements.txt

配置

不需要配置。服务器直接连接到Baltimore的公共API端点。

用法

运行服务器

使用stdio（标准输入/输出）运行服务器：

python3.11 server.py

或者使用提供的运行脚本：

./run_server.sh

测试

运行综合测试套件：

python3.11 test_comprehensive.py

MCP客户端配置

要将此服务器与MCP客户端（如Claude Desktop）一起使用，请将其添加到MCP配置文件中：

适用于克劳德桌面 (~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "balt-permit": {
      "command": "python3.11",
      "args": ["/path/to/balt-permit-mcp-server/server.py"]
    }
  }
}

替换 /path/to/balt-permit-mcp-server 此目录的实际绝对路径。

对于其他MCP客户端，根据客户的文档进行配置。

可用工具

search_permits_by_address

按地址或地址模式搜索许可证。

参数：

• address （必填）：要搜索的地址或地址的一部分（例如，“100 Main St”或“Main”）
• limit （可选）：返回的最大结果数（默认值：50，最大值：1000）

例子：

{
  "address": "Pratt St",
  "limit": 20
}

search_permits_by_date_range

搜索在特定日期范围内发放的许可证。

参数：

• start_date （必填）：开始日期，格式为YYYY-MM-DD
• end_date （必填）：YYYY-MM-DD格式的结束日期
• limit （可选）：返回的最大结果数（默认值：50，最大值：1000）

例子：

{
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "limit": 100
}

search_permits_by_neighborhood

在特定社区搜索许可证。

参数：

• neighborhood （必填）：邻里名称（例如“Fells Point”、“Canton”）
• limit （可选）：返回的最大结果数（默认值：50，最大值：1000）

例子：

{
  "neighborhood": "Fells Point",
  "limit": 50
}

search_permits_by_case_number

根据案件编号获得特定许可证。

参数：

• case_number （必填）：许可证案例编号（例如“COM2018-86246”）

例子：

{
  "case_number": "COM2018-86246"
}

get_recent_permits

获得最近颁发的许可证。

参数：

• limit （可选）：返回的最大结果数（默认值：50，最大值：1000）
• days （可选）：回顾的天数（默认值：30）

例子：

{
  "limit": 25,
  "days": 7
}

count_permits

Count允许匹配SQL WHERE子句。

参数：

• where_clause （必需）：用于筛选的SQL WHERE子句

例子：

{
  "where_clause": "Council_District = 1 AND Cost > 10000"
}

数据源

此服务器连接到巴尔的摩市的ArcGIS FeatureServer：

• 端点: https://egisdata.baltimorecity.gov/egis/rest/services/Housing/DHCD_Open_Baltimore_Datasets/FeatureServer/3
• 格式GeoJSON：
• 数据：住房和社区发展部（DHCD）的建筑许可证

许可数据字段

每份许可证包括以下信息：

• 案例编号：唯一的许可证案例编号
• 地址：物业地址
• 邻里：邻里名称
• 发布日期：许可证签发日期
• 到期日：许可证到期日期
• 成本：预计项目成本
• 描述：详细的工作描述
• 块状地块：区块和批号
• 市议会_区：市议会区号
• 现有用途：现有土地使用代码
• 建议使用：拟议土地使用法
• IsPermit修改：这是否是许可证修改
• 位置地理坐标（纬度、经度）

许可证

此MCP服务器按原样提供。数据源是巴尔的摩市的开放数据，可在其 公开数据政策.

备注

• API可能返回结果 exceededTransferLimit: true 当有许多匹配的许可证时。在这种情况下，结果可能会被截断。
• 日期查询使用基于API内部格式的时间戳比较（自epoch以来的毫秒）。
• 地址和邻居搜索不区分大小写，支持部分匹配。

支持

有关此MCP服务器的问题或疑问，请在存储库中打开问题。

有关基础数据的问题，请联系巴尔的摩市的开放数据团队。

开放波罗的海mcp

MCP用于访问巴尔的摩的开放数据