ng-postcode-mcp 0.2.0__tar.gz → 0.2.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/PKG-INFO +18 -7
  2. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/README.md +17 -6
  3. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/pyproject.toml +1 -1
  4. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/server.json +2 -2
  5. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/.gitignore +0 -0
  6. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/LICENSE +0 -0
  7. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/src/ng_postcode_mcp/__init__.py +0 -0
  8. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/src/ng_postcode_mcp/__main__.py +0 -0
  9. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/src/ng_postcode_mcp/py.typed +0 -0
  10. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/src/ng_postcode_mcp/server.py +0 -0
  11. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/tests/test_metadata.py +0 -0
  12. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/tests/test_resolve_tool.py +0 -0
  13. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/tests/test_stdio.py +0 -0
  14. {ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/tests/test_tools.py +0 -0
{ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: ng-postcode-mcp
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: MCP server for Nigeria's NIPOST digital postcode (NDAPS): validate, look up, reverse-geocode and resolve addresses to postcodes.
5
5
  Project-URL: Repository, https://github.com/Adeniyikayodee/ng-postcode
6
6
  Project-URL: Issues, https://github.com/Adeniyikayodee/ng-postcode/issues
@@ -62,15 +62,17 @@ Text alone rarely identifies a building, so ask users for a location pin when th
62
62
 
63
63
  ## Install
64
64
 
65
- Requires [uv](https://docs.astral.sh/uv/). Get an API key from the [NIPOST developer dashboard](https://dashboard.postcode.gov.ng); `validate_postcode` works without one.
65
+ Works with any MCP client. The server runs over stdio:
66
66
 
67
- **Claude Code**
67
+ | Setting | Value |
68
+ | --- | --- |
69
+ | Command | `uvx` |
70
+ | Arguments | `ng-postcode-mcp` |
71
+ | Environment | `NG_POSTCODE_API_KEY` (optional for `validate_postcode`) |
68
72
 
69
- ```sh
70
- claude mcp add ng-postcode -e NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-postcode-mcp
71
- ```
73
+ It needs [uv](https://docs.astral.sh/uv/) installed. Get an API key from the [NIPOST developer dashboard](https://dashboard.postcode.gov.ng).
72
74
 
73
- **Claude Desktop, Cursor and other clients** that use an `mcpServers` config:
75
+ Most clients take this entry in their MCP settings:
74
76
 
75
77
  ```json
76
78
  {
@@ -84,6 +86,15 @@ claude mcp add ng-postcode -e NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-post
84
86
  }
85
87
  ```
86
88
 
89
+ | Client | How to add it |
90
+ | --- | --- |
91
+ | Claude Code | `claude mcp add ng-postcode -e NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-postcode-mcp` |
92
+ | Claude Desktop | The entry above, in its MCP server settings |
93
+ | Codex | `codex mcp add ng-postcode --env NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-postcode-mcp` |
94
+ | Cursor | The entry above, in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global) |
95
+ | VS Code | The same server object in `.vscode/mcp.json`, under a top-level `"servers"` key instead of `"mcpServers"` |
96
+ | Others | Any client that launches stdio servers: use the command, arguments and environment above |
97
+
87
98
  ## Configuration
88
99
 
89
100
  | Variable | Default | Purpose |
{ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/README.md RENAMED
@@ -34,15 +34,17 @@ Text alone rarely identifies a building, so ask users for a location pin when th
34
34
 
35
35
  ## Install
36
36
 
37
- Requires [uv](https://docs.astral.sh/uv/). Get an API key from the [NIPOST developer dashboard](https://dashboard.postcode.gov.ng); `validate_postcode` works without one.
37
+ Works with any MCP client. The server runs over stdio:
38
38
 
39
- **Claude Code**
39
+ | Setting | Value |
40
+ | --- | --- |
41
+ | Command | `uvx` |
42
+ | Arguments | `ng-postcode-mcp` |
43
+ | Environment | `NG_POSTCODE_API_KEY` (optional for `validate_postcode`) |
40
44
 
41
- ```sh
42
- claude mcp add ng-postcode -e NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-postcode-mcp
43
- ```
45
+ It needs [uv](https://docs.astral.sh/uv/) installed. Get an API key from the [NIPOST developer dashboard](https://dashboard.postcode.gov.ng).
44
46
 
45
- **Claude Desktop, Cursor and other clients** that use an `mcpServers` config:
47
+ Most clients take this entry in their MCP settings:
46
48
 
47
49
  ```json
48
50
  {
@@ -56,6 +58,15 @@ claude mcp add ng-postcode -e NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-post
56
58
  }
57
59
  ```
58
60
 
61
+ | Client | How to add it |
62
+ | --- | --- |
63
+ | Claude Code | `claude mcp add ng-postcode -e NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-postcode-mcp` |
64
+ | Claude Desktop | The entry above, in its MCP server settings |
65
+ | Codex | `codex mcp add ng-postcode --env NG_POSTCODE_API_KEY=nipost_live_... -- uvx ng-postcode-mcp` |
66
+ | Cursor | The entry above, in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global) |
67
+ | VS Code | The same server object in `.vscode/mcp.json`, under a top-level `"servers"` key instead of `"mcpServers"` |
68
+ | Others | Any client that launches stdio servers: use the command, arguments and environment above |
69
+
59
70
  ## Configuration
60
71
 
61
72
  | Variable | Default | Purpose |
{ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/pyproject.toml RENAMED
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "ng-postcode-mcp"
7
- version = "0.2.0"
7
+ version = "0.2.1"
8
8
  description = "MCP server for Nigeria's NIPOST digital postcode (NDAPS): validate, look up, reverse-geocode and resolve addresses to postcodes."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
{ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/server.json RENAMED
@@ -3,7 +3,7 @@
3
3
  "name": "io.github.Adeniyikayodee/ng-postcode",
4
4
  "title": "Nigeria Postcode",
5
5
  "description": "Validate, look up and resolve addresses to Nigeria's NIPOST digital postcodes (NDAPS).",
6
- "version": "0.2.0",
6
+ "version": "0.2.1",
7
7
  "repository": {
8
8
  "url": "https://github.com/Adeniyikayodee/ng-postcode",
9
9
  "source": "github",
@@ -13,7 +13,7 @@
13
13
  {
14
14
  "registryType": "pypi",
15
15
  "identifier": "ng-postcode-mcp",
16
- "version": "0.2.0",
16
+ "version": "0.2.1",
17
17
  "runtimeHint": "uvx",
18
18
  "transport": {
19
19
  "type": "stdio"
{ng_postcode_mcp-0.2.0 → ng_postcode_mcp-0.2.1}/LICENSE RENAMED
File without changes