Cover image
Try Now
2025-04-03

3 years

Works with Finder

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.

相关推荐

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Lists Tailwind CSS classes in monospaced font

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • https://appia.in
  • Siri Shortcut Finder – your go-to place for discovering amazing Siri Shortcuts with ease

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://zenepic.net
  • Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • jae-jae
  • MCP server for fetch web page content using Playwright headless browser.

  • HiveNexus
  • An AI chat bot for small and medium-sized teams, supporting models such as Deepseek, Open AI, Claude, and Gemini. 专为中小团队设计的 AI 聊天应用,支持 Deepseek、Open AI、Claude、Gemini 等模型。

  • ravitemer
  • A powerful Neovim plugin for managing MCP (Model Context Protocol) servers

  • patruff
  • Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

    Reviews

    5 (1)
    Avatar
    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!