CHRISCARLON/os-mcp
If you are the rightful owner of os-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Python-based MCP server that provides access to the Ordnance Survey APIs, supporting both STDIO and HTTP (streamable) modes.
Ordnance Survey MCP Server
A MCP server for accessing UK geospatial data through Ordnance Survey APIs.
What it does
Provides LLM access to the Ordnance Survey's Data Hub APIs.
Ask simple questions such as find me all cinemas in Leeds City Centre or use the prompts templates for more complex, speciifc use cases - relating to street works, planning, etc.
This MCP server enforces a 2 step workflow plan to ensure that the user gets the best results possible.
Quick Start
1. Get an OS API Key
Register at OS Data Hub to get your free API key and set up a project.
2. Run with Docker and add to your Claude Desktop config (easiest)
Clone the repository:
git clone https://github.com/your-username/os-mcp-server.git
cd os-mcp-server
Then build the Docker image:
docker build -t os-mcp-server .
Add the following to your Claude Desktop config:
{
"mcpServers": {
"os-mcp-server": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"OS_API_KEY=your_api_key_here",
"-e",
"STDIO_KEY=any_value",
"os-mcp-server"
]
}
}
}
Open Claude Desktop and you should now see all available tools, resources, and prompts.
Requirements
- Python 3.11+
- OS API Key from OS Data Hub
- Set a STDIO_KEY env var which can be any value for now whilst auth is improved.
License
MIT License. This project does not have the endorsement of Ordnance Survey. This is a personal project and not affiliated with Ordnance Survey. This is not a commercial product. It is actively being worked on so expect breaking changes and bugs.
