Public
Postcodes-uk-MCP-Server
2025-04-03
1
Github Watches
1
Github Forks
0
Github Stars
Postcodes UK MCP Server
Overview
Postcodes UK MCP Server provides an efficient way to interact with the UK Postcodes API (postcodes.io). It offers validation, lookup, and geographical search capabilities for UK postcodes.
Features
- Validate UK postcodes
- Retrieve postcode details
- Bulk postcode lookup
- Find nearest postcodes by coordinates
Dependencies
- Python 3.8+
-
mcp-cli&httpx
Installation Steps
1. Install uv with official standalone installer:
For macOS and Linux
$ curl -LsSf https://astral.sh/uv/install.sh | sh
For Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex
2. Clone the repo
Then add MCP to your project dependencies:
uv add "mcp[cli]"
3. Make sure Claude Desktop App installed from Claude
4. Now install the Postcodes UK MCP Server to the Claude Desktop
mcp install postcodes.py
You will see the output like this after successful installation
INFO Added server 'postcodes' to Claude config claude.py:129
INFO Successfully installed postcodes in Claude app cli.py:467
Usage
The server provides multiple methods to interact with UK postcode data:
- Lookup details for a single postcode
- Perform bulk postcode lookups
- Find nearest postcodes by geographic coordinates
Demo on Claude Desktop:
API Endpoints
| Endpoint | Description |
|---|---|
/lookup/{postcode} |
Retrieve details for a single postcode |
/bulk-lookup |
Look up multiple postcodes at once |
/nearest?lat={lat}&lon={lon} |
Find nearest postcodes based on coordinates |
📌 Contributing
Contributions are welcome! Feel free to submit issues or pull requests.
📄 License
This project is licensed under the MIT License.
⭐ Support
If you find this project useful, please ⭐ star the repository! and Find me in LinkedIn
Developed with ❤️ for UK postcode services.
相关推荐
I find academic articles and books for research and literature reviews.
Confidential guide on numerology and astrology, based of GG33 Public information
Advanced software engineer GPT that excels through nailing the basics.
Take an adjectivised noun, and create images making it progressively more adjective!
Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.
Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.
Découvrez la collection la plus complète et la plus à jour de serveurs MCP sur le marché. Ce référentiel sert de centre centralisé, offrant un vaste catalogue de serveurs MCP open-source et propriétaires, avec des fonctionnalités, des liens de documentation et des contributeurs.
Manipulation basée sur Micropython I2C de l'exposition GPIO de la série MCP, dérivée d'Adafruit_MCP230XX
L'application tout-en-un desktop et Docker AI avec chiffon intégré, agents AI, constructeur d'agent sans code, compatibilité MCP, etc.
Miroir dehttps: //github.com/bitrefill/bitrefill-mcp-server
Un puissant plugin Neovim pour gérer les serveurs MCP (Protocole de contexte modèle)
Reviews
5
(1)
user_fblqpYTD
2025-04-16
As a dedicated user of the postcodes-uk-mcp-server by selva221724, I am thoroughly impressed with its performance and reliability. This server effectively handles UK postcode data, making it an essential tool for developers working on location-based applications. The setup is straightforward, and the comprehensive documentation provided on GitHub ensures a seamless experience. Highly recommended for anyone needing accurate and efficient postcode management!