A
Adeniyikayodee/ng-postcode
Validate Nigerian postcodes in Rust, Python, JavaScript, Java, PostgreSQL, DuckDB, and Polars, with MCP servers for AI agents. Covers Nigeria's NIPOST digital postcode (NDAPS): offline validation, lookup, and reverse geocoding.
无 SECURITY.md
在 GitHub 查看 ↗链接已于 2026-11-12 核查 · HTTP 200 · 打开的是厂商自己的官网
安装与配置
- 复制上面的命令
- 粘成
claude_desktop_config.json里mcpServers的一项（本地服务器用 command + args，示例见 客户端接法） - 重启客户端
客户端配置（取自该仓库的安装命令）
{
"mcpServers": {
"adeniyikayodee-ng-postcode-tree-main-mcp": {
"command": "uvx",
"args": ["ng-postcode-mcp"]
}
}
}解析自我们于 2026-10-26 抓取的该仓库 README；我们未执行过。
command/args 来自仓库写明的安装命令；不确定时请以该项目 README 为准。
VS Code（.vscode/mcp.json —— 键名是 servers）
{
"servers": {
"adeniyikayodee-ng-postcode-tree-main-mcp": {
"command": "uvx",
"args": ["ng-postcode-mcp"]
}
}
}VS Code 顶层键是 <code>servers</code>，其余与上面那份相同。
Claude Code（命令行）
claude mcp add --transport stdio adeniyikayodee-ng-postcode-tree-main-mcp -- uvx ng-postcode-mcp
Claude Code 不收 JSON 文件，用这条命令直接加。
配置项的键名以你的客户端为准：客户端与 CLI
- ★ 数取值
- 7 ★ · Adeniyikayodee/ng-postcode · 取自 GitHub 搜索 API · （2026-11-13 20:00:50 核对）
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单（我们从中收集的条目之一） · 条目类型：MCP 服务
- 收录与活跃
- 收录于 2026-10-23 · 最近见到 2026-11-14 · 共见到 26 次 · 被 23 个来源列出
- 评分构成
- 综合分 2,300 · 7 ★ · 23 个来源 · mcp
- 安装
uvx ng-postcode-mcp
常见问题（答案都来自我们的记录）
怎么安装？
该仓库给出的安装命令是
uvx ng-postcode-mcp。我们的记录里它是仓库自己提供的；不保证在你的客户端上直接可用。它适合谁 / 用来做什么？
我们把它归在这些标签下: MCP 服务。标签来自条目自身，不是我们强加的分类。
谁维护它、还在更新吗？
仓库
Adeniyikayodee/ng-postcode；我们收录于 2026-10-23；最近见到 2026-11-14。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。# ng-postcode
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Developer tools for Nigeria's National Digital Alphanumeric Postcode System (NDAPS), the building-level postcode NIPOST launched in October 2026: libraries for Rust and Python (ng-postcode), JavaScript (ng-postcode-js on npm), and Java (ng-postcode-api), MCP servers for AI assistants on PyPI and npm, and a resolver that turns described addresses into postcodes.
A postcode has 11 characters in five segments, written EK-01-A03-FK-01: state, LGA, district, area and building unit. NIPOST's own example, FC 02 A09 DB 09, is the same shape with spaces.
## Packages
| Package | What it does | Install | Source |
| ng-postcode (Rust) | Parse, validate and format codes offline; client for the postcode.gov.ng API | cargo add ng-postcode | src/, docs |
| ng-postcode (Python) | The same behaviour, with sync and async clients | pip install ng-postcode | python/ |
| ng-postcode-js | The same behaviour for JavaScript and TypeScript, with a fetch client | npm install ng-postcode-js | js/packages/ng-postcode-js |
| ng-postcode and ng-postcode-api (Java) | The same behaviour for Java 17 and later; the core has no dependencies | io.github.adeniyikayodee:ng-postcode-api | java/ |
| ng-postcode-mcp | MCP server: validate, look up, autocomplete, find by location, resolve addresses | uvx ng-postcode-mcp | mcp/ |
| ng-postcode-mcp (npm) | The same server for Node, without address resolution | npx ng-postcode-mcp | js/packages/ng-postcode-mcp |
| ng-postcode-polars | Polars expressions that parse, format and group codes by place, compiled from the Rust core | pip install ng-postcode-polars | native/polars |
| ngpostcode (PostgreSQL) | The postcode as native 8-byte types with index support, compiled from the Rust core | Package from Releases, then CREATE EXTENSION ngpostcode | native/pg |
| ngpostcode (DuckDB) | The same functions as a DuckDB extension, compiled from the Rust core | INSTALL ngpostcode FROM community (DuckDB 1.5.6) | ng-postcode-duckdb |
| ng-address-resolver | Resolve free-text addresses to postcodes, only as precisely as the evidence allows (pre-alpha) | pip install ng-address-resolver | agent/ |
Each package has its own README with full usage.
For databases, sql/ holds the postcode as a PostgreSQL domain and as DuckDB macros, in plain SQL that runs the same shared cases.
Two names are easy to get wrong. On npm the library is ng-postcode-js, because ng-postcode there is another project. ng-address-resolver is imported as ngaddress.
For online stores, ng-postcode-woocommerce is a WooCommerce plugin built on the same rules and the same shared test cases: it checks and tidies the postcode at checkout, finds it from the customer's location, and makes shipping zones match on postcode prefixes.
For React and Next.js, templates/nigerian-address-form is a checkout address form built with shadcn/ui and ng-postcode-js. Add it with npx shadcn@latest add https://adeniyikayodee.github.io/ng-postcode/r/nigerian-address-form.json, or deploy the folder as an app.
## Quick start
Parsing and validation are offline and need no key.
Python
python
from ngpostcode import Postcode, parse
match parse("ek 01 a03 fk 01"):
case Postcode() as code:
A postcode has 11 characters in five segments, written EK-01-A03-FK-01: state, LGA, district, area and building unit. NIPOST's own example, FC 02 A09 DB 09, is the same shape with spaces.
## Packages
| Package | What it does | Install | Source |
| ng-postcode (Rust) | Parse, validate and format codes offline; client for the postcode.gov.ng API | cargo add ng-postcode | src/, docs |
| ng-postcode (Python) | The same behaviour, with sync and async clients | pip install ng-postcode | python/ |
| ng-postcode-js | The same behaviour for JavaScript and TypeScript, with a fetch client | npm install ng-postcode-js | js/packages/ng-postcode-js |
| ng-postcode and ng-postcode-api (Java) | The same behaviour for Java 17 and later; the core has no dependencies | io.github.adeniyikayodee:ng-postcode-api | java/ |
| ng-postcode-mcp | MCP server: validate, look up, autocomplete, find by location, resolve addresses | uvx ng-postcode-mcp | mcp/ |
| ng-postcode-mcp (npm) | The same server for Node, without address resolution | npx ng-postcode-mcp | js/packages/ng-postcode-mcp |
| ng-postcode-polars | Polars expressions that parse, format and group codes by place, compiled from the Rust core | pip install ng-postcode-polars | native/polars |
| ngpostcode (PostgreSQL) | The postcode as native 8-byte types with index support, compiled from the Rust core | Package from Releases, then CREATE EXTENSION ngpostcode | native/pg |
| ngpostcode (DuckDB) | The same functions as a DuckDB extension, compiled from the Rust core | INSTALL ngpostcode FROM community (DuckDB 1.5.6) | ng-postcode-duckdb |
| ng-address-resolver | Resolve free-text addresses to postcodes, only as precisely as the evidence allows (pre-alpha) | pip install ng-address-resolver | agent/ |
Each package has its own README with full usage.
For databases, sql/ holds the postcode as a PostgreSQL domain and as DuckDB macros, in plain SQL that runs the same shared cases.
Two names are easy to get wrong. On npm the library is ng-postcode-js, because ng-postcode there is another project. ng-address-resolver is imported as ngaddress.
For online stores, ng-postcode-woocommerce is a WooCommerce plugin built on the same rules and the same shared test cases: it checks and tidies the postcode at checkout, finds it from the customer's location, and makes shipping zones match on postcode prefixes.
For React and Next.js, templates/nigerian-address-form is a checkout address form built with shadcn/ui and ng-postcode-js. Add it with npx shadcn@latest add https://adeniyikayodee.github.io/ng-postcode/r/nigerian-address-form.json, or deploy the folder as an app.
## Quick start
Parsing and validation are offline and need no key.
Python
python
from ngpostcode import Postcode, parse
match parse("ek 01 a03 fk 01"):
case Postcode() as code:
收录徽章（可选）
想把收录标记放进 README 就复制这行，可选，不影响收录。
[](https://anclum.com/zh/s/adeniyikayodee-ng-postcode-tree-main-mcp/)
- 来源
- awesome · https://github.com/Adeniyikayodee/ng-postcode/tree/main/mcp
- 按领域浏览
- MCP 服务
- Traction
- 7 ★（父仓库总星标，不是这一条自己的）
- 收录来源
- 23 个独立来源
- 收录于
- 今天
- 安全策略
- 我们没在该仓库根目录找到
SECURITY.md（这不代表不安全）
同类推荐
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。