原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

US Places, Then

作者:ianderso版本 0.2.0i★ –i在你的电脑上运行
注册名称io.github.ianderso/us-places-mcp

安装

概览

作者提供的说明(英文原文)

US places then: county on a date, PLSS land, GNIS names, old topo maps, post offices.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在你的电脑上运行
  • 传输方式: stdio
  • 分类: 旅行、地图与天气

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

  • 基础检查:1 项中通过 1 项
  • 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
  • 需要你自己填写: US_PLACES_OVERPASS_URL, US_PLACES_PLSS_URL, US_PLACES_GNIS_URL, US_PLACES_GNIS_ARCHIVE_URL, US_PLACES_TNM_URL, US_PLACES_DATAVERSE_URL, US_PLACES_CACHE_DIR, US_PLACES_TIMEOUT, US_PLACES_CONTACT

你需要

  • PyPI已安装 Python 的 uv(用于 uvx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "us-places": {
      "command": "uvx",
      "args": [
        "us-places-mcp"
      ],
      "env": {
        "US_PLACES_OVERPASS_URL": "your-value",
        "US_PLACES_PLSS_URL": "your-value",
        "US_PLACES_GNIS_URL": "your-value",
        "US_PLACES_GNIS_ARCHIVE_URL": "your-value",
        "US_PLACES_TNM_URL": "your-value",
        "US_PLACES_DATAVERSE_URL": "your-value",
        "US_PLACES_CACHE_DIR": "your-value",
        "US_PLACES_TIMEOUT": "your-value",
        "US_PLACES_CONTACT": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add us-places --env US_PLACES_OVERPASS_URL=your-value --env US_PLACES_PLSS_URL=your-value --env US_PLACES_GNIS_URL=your-value --env US_PLACES_GNIS_ARCHIVE_URL=your-value --env US_PLACES_TNM_URL=your-value --env US_PLACES_DATAVERSE_URL=your-value --env US_PLACES_CACHE_DIR=your-value --env US_PLACES_TIMEOUT=your-value --env US_PLACES_CONTACT=your-value -- uvx us-places-mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "us-places": {
      "command": "uvx",
      "args": [
        "us-places-mcp"
      ],
      "env": {
        "US_PLACES_OVERPASS_URL": "your-value",
        "US_PLACES_PLSS_URL": "your-value",
        "US_PLACES_GNIS_URL": "your-value",
        "US_PLACES_GNIS_ARCHIVE_URL": "your-value",
        "US_PLACES_TNM_URL": "your-value",
        "US_PLACES_DATAVERSE_URL": "your-value",
        "US_PLACES_CACHE_DIR": "your-value",
        "US_PLACES_TIMEOUT": "your-value",
        "US_PLACES_CONTACT": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "us-places": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "us-places-mcp"
      ],
      "env": {
        "US_PLACES_OVERPASS_URL": "your-value",
        "US_PLACES_PLSS_URL": "your-value",
        "US_PLACES_GNIS_URL": "your-value",
        "US_PLACES_GNIS_ARCHIVE_URL": "your-value",
        "US_PLACES_TNM_URL": "your-value",
        "US_PLACES_DATAVERSE_URL": "your-value",
        "US_PLACES_CACHE_DIR": "your-value",
        "US_PLACES_TIMEOUT": "your-value",
        "US_PLACES_CONTACT": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • US_PLACES_OVERPASS_URL env
    OpenHistoricalMap's Overpass endpoint.
  • US_PLACES_PLSS_URL env
    BLM's national PLSS (CadNSDI) map service.
  • US_PLACES_GNIS_URL env
    USGS's GNIS map service (The National Map).
  • US_PLACES_GNIS_ARCHIVE_URL env
    Where USGS keeps the August 2021 GNIS state files.
  • US_PLACES_TNM_URL env
    The National Map's TNM Access products API.
  • US_PLACES_DATAVERSE_URL env
    Harvard Dataverse, which holds the US post offices dataset.
  • US_PLACES_CACHE_DIR env
    Directory for the on-disk response cache and the downloaded datasets.
  • US_PLACES_TIMEOUT env
    HTTP timeout in seconds.
  • US_PLACES_CONTACT env
    An email address or URL appended to the User-Agent, so the services can reach whoever runs the server.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 ianderso 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

与“旅行、地图与天气”中的其他服务器比较i

  • 星标数多于此分类中其他 1719 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 1719 个服务器的 49% 更新
  • 基础检查结果等于或优于此分类中其他 1719 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

US Places, Then 安全吗?

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(0.2.0)于32天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它?

同一分类中有:Find a real estate agent, Sorted Travel Docs, Sorted Travel

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Find a real estate agent

作者:app.getrealtymind.com

Find brokerages that serve an area and book a buying or selling consultation. No sign-in.

在云端运行今天更新
安装

Sorted Travel Docs

作者:a-l-e-x-k

Search Sorted Travel developer docs for MCP, API, SDK, and auth questions.

在云端运行今天更新
安装

Sorted Travel

作者:a-l-e-x-k

Travel ranking, place facts, weather, visa, and profile tools for Sorted Travel.

在云端运行今天更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

us-places-mcp

An MCP server for where things were, then. Records follow the jurisdiction that held a place on the date of the event, not today's: a 1795 deed for a farm now in Greene County, Pennsylvania, is in Washington County's books, because Greene was carved out the next year. This server answers the questions that decide which office to write to:

  • Which county held this spot on that date? From the Newberry Library's *Atlas of Historical County Boundaries*, which records every creation and boundary change of every US county from 1629 to 2000, dated to the day, with the act behind it. OpenHistoricalMap imported the atlas and serves it free (CC0); this server asks it.
  • Where is this land description on the ground? "E½NE Sec. 18, T84N R39W, 5th P.M." becomes a centroid, a bounding box and BLM's ids, from the Bureau of Land Management's national Public Land Survey data. A map pin becomes a land description the other way.
  • Where is the case file behind this land patent? The patent is the end of a process. The file at the National Archives holds the application and, for a homestead, years of residence, witnesses and citizenship papers. The server says which file and which series, and builds the search.
  • Where was Mount Hope Cemetery, or Hines Corners? USGS's Geographic Names Information System (GNIS) names and places every feature it knows, including vanished towns marked "(historical)". In 2021 it dropped cemeteries, churches, schools, post offices and other built features; the server also searches the archive USGS kept from August 2021, and says which answered.
  • Which post offices were there, and when? Richard Helbock's list of every US post office from 1639 to 2000, geocoded by Cameron Blevins: 166,140 offices with the years they opened and closed. A post office is often the only trace of a hamlet.
  • Which old maps show the spot? Every USGS topographic map since 1884 that covers a point, oldest first, with links to the scans.

Nothing here writes anywhere, and nothing here keeps a family tree. It sits well beside nara-catalog-mcp, which can run the archive searches this server builds, familysearch-mcp and snac-archives-mcp.

This is an independent project. It is not affiliated with, endorsed by, or supported by the Newberry Library, OpenHistoricalMap, the Bureau of Land Management, the US Geological Survey, Harvard Dataverse, the dataset's authors or the National Archives.

Tools

The server publishes twelve tools, all read-only and annotated so for the client. Five make no network call at all.

Jurisdiction at a date

ToolPurpose
county_atThe county (or counties) that held a point on a date: a day, a month or a year. Returns the holder, its dates, the event and statute that made it, the whole chain of counties for that spot, changes within a year (check those by hand), and whether two governments contested it.
county_historyEvery version of one county: created when, from what, and each later change, with statutes.

Federal land

ToolPurpose
parse_legal_descriptionRead a land description, however it is written (E½NE, E2NE, E 1/2 NE 1/4, "the east half of the northeast quarter", GLO's padded 0840N, lots, several tracts), into its parts, with quarter-quarters and warnings for anything guessed. Offline.
plss_locatePlace a description on the map: centroid, bounding box, acreage and BLM's ids, to the township, section, quarter-quarter or lot.
plss_from_pointName the survey tract at a point: township, range, section and quarter-quarter.
public_land_stateWas this state federal land? If not, who granted first title and where those records are; if so, its meridians and special cases. Offline.

Vanished places and old maps

ToolPurpose
find_place_nameA named place in GNIS: its point, class, state and county. Searches the live GNIS and, given a state, the archive of August 2021 that keeps the cemeteries, churches, schools, post offices and buildings GNIS dropped that year; says which answered.
post_officesWhich US post offices existed, 1639-2000: by name, by state and today's county, or around a point, and in a given year. Each with its years, whether it ran continuously, and its point if it was geocoded.
historical_topo_mapsEvery USGS topographic map covering a point, oldest first: date, scale and quadrangle, with GeoPDF, GeoTIFF and JPEG preview links, and a TopoView link for JPEG and KMZ.

From patent to case file

ToolPurpose
find_land_entry_fileFrom a patent's Authority: the kind of entry, what its file holds, which National Archives series has it, ready-made arguments for nara-catalog-mcp's search_records_advanced, and how to order the file if it is not online. Offline.
glo_linksA link to a search, or to one record, on BLM's General Land Office Records site, for you to open. Offline.
cache_statusThis session's live calls and cache hits, and the datasets downloaded so far. Offline.

Setup

You need Python 3.11 or later and uv. There is no key to request.

uvx us-places-mcp

or from a clone:

git clone https://github.com/ianderso/us-places-mcp

cd us-places-mcp uv sync uv run us-places-mcp # stdio server, usually launched by the client

Claude Desktop
{

"mcpServers": { "places": { "command": "uvx", "args": ["us-places-mcp"] } } }

If the server fails to start because uvx cannot be found, give the full path that which uvx prints as the command.

Claude Code
claude mcp add places -- uvx us-places-mcp

Configuration

Nothing is required. A .env file in the directory the server starts in supplies anything the environment does not; only that directory is read.

VariableMeaning
US_PLACES_OVERPASS_URLOpenHistoricalMap's Overpass endpoint. Default https://overpass-api.openhistoricalmap.org/api/interpreter.
US_PLACES_PLSS_URLBLM's national PLSS map service. Default https://gis.blm.gov/arcgis/rest/services/Cadastral/BLM_Natl_PLSS_CadNSDI/MapServer.
US_PLACES_GNIS_URLUSGS's GNIS map service. Default https://carto.nationalmap.gov/arcgis/rest/services/geonames/MapServer.
US_PLACES_GNIS_ARCHIVE_URLThe folder of GNIS state files from August 2021. Default https://prd-tnm.s3.amazonaws.com/StagedProducts/GeographicNames/Archive/MainDomestic.
US_PLACES_TNM_URLThe National Map's TNM Access products API. Default https://tnmaccess.nationalmap.gov/api/v1/products.
US_PLACES_DATAVERSE_URLHarvard Dataverse, which holds the post-office dataset. Default https://dataverse.harvard.edu.
US_PLACES_CACHE_DIRResponse cache directory; downloaded datasets go in its data folder. Default ~/.cache/us-places-mcp.
US_PLACES_TIMEOUTHTTP timeout in seconds. Default 60.
US_PLACES_CONTACTAn email address or URL added to the User-Agent, so the services can reach you. Optional, and courteous.

Every URL must be https. Their hosts, and Dataverse's file store (dvn-cloud-iqss.s3.amazonaws.com, where it redirects downloads), are the only ones the server will contact.

Being a good guest

OpenHistoricalMap's Overpass server runs on donated capacity and publishes no rate limit. The server sends one request at a time to each service, two seconds apart for OpenHistoricalMap, half a second for BLM and a second for USGS and Dataverse, joins identical calls in flight, and caches answers on disk: county answers for 90 days, GNIS and map answers for 30, survey answers until you pass refresh=true. A 429 or a 5xx is retried three times with back-off, then reported as rate_limited or upstream_error, which is never the same as "nothing here".

Downloaded data

Two sources are files rather than services, so the server downloads them once and reads them locally. Nothing is downloaded until a tool needs it, and the result that triggered a download says so: what, how big, how it was checked and where it was saved.

DataWhenSizeChecked against
US Post Offices (Blevins and Helbock, doi:10.7910/DVN/NUKCNA, CC0)The first post_offices call31 MB download, 21 MB on diskThe MD5 Dataverse publishes for the file
GNIS state file of 25 August 2021 (USGS, public domain)The first find_place_name search in that stateUp to 17 MB per state (Pennsylvania 9.8 MB); only the dropped classes are kept, about 6 MB for PennsylvaniaThe ETag USGS's bucket reports (an MD5, or the MD5 of the upload's parts)

Both are stored as SQLite files in data under the cache directory (~/.cache/us-places-mcp/data by default), never in the repository. A file that fails its check is deleted and the tool reports download_failed. cache_status lists what is there; delete the folder to start again.

How to read what comes back

  • The county then, not now. A record was made by the county that held the place on the day. A new county does not take its parent's earlier records, so a deed from before Greene County existed is in Washington County's books still.
  • Check dates near a change. boundary_change_within_a_year lists changes close to your date. Laws took effect on stated days, but offices took time to organise; records from those months can be in either county.
  • "Attached to". Before an area was organised as a county it was often attached to a neighbour for administration, and that neighbour kept its records. county_at reads this from the atlas's event text.
  • Contested ground. Pennsylvania and Virginia both governed the Waynesburg area in the 1770s, and similar disputes ran elsewhere. "status": "contested" means look in both governments' records.
  • The atlas files counties under today's state. Monongalia County was created by Virginia but is filed under West Virginia; the event text says which government acted.
  • The atlas ends in 2000 and holds counties only: not towns, townships or parishes as church units.
  • A located tract is not a house. A section's centre is up to half a mile from any point in it, and BLM's data is a modern compilation that can differ from the original plat near correction lines and water. Lotted sections (along a township's north and west edges, or by water) have lots where a regular section has quarter-quarters.
  • A parse is a reading of a reading. parse_legal_description keeps the original text and says what it guessed: a section number with no "Sec.", a meridian taken from the state.
  • A patent proves a conveyance, on its signature date. The entry was years earlier: homesteaders lived on the land five years before final proof, and mid-century backlogs put years between purchase and signature. The Homestead Act took effect in 1863, so an "1856 homestead" in a family story is a cash, credit, preemption or warrant entry.
  • The patentee may never have seen the land. Military bounty-land warrants were bought and sold; the veteran is in the warrant file, the patentee may be a speculator.
  • No federal patents in state-land states. The thirteen colonies, Maine, Vermont, Kentucky, Tennessee, West Virginia, Texas and Hawaii granted

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx