This is a Model Context Protocol (MCP) server designed specifically for AI agents and LLM applications. It acts as a bridge between artificial intelligence systems and the comprehensive OpenStreetMap tagging knowledge base provided by the official @openstreetmap/id-tagging-schema library. Current Status: Production-ready MCP server, actively maintained and continuously improved. The service is dep
Add this skill
npx mdskills install gander-tools/osm-tagging-schema-mcpComprehensive MCP server for OpenStreetMap tagging with 7 well-documented tools and strong CI/CD practices
1# OpenStreetMap Tagging Schema MCP Server23<!-- CI/CD Status -->4[](https://github.com/gander-tools/osm-tagging-schema-mcp/actions/workflows/test.yml)5[](https://github.com/gander-tools/osm-tagging-schema-mcp/actions/workflows/fuzz.yml)6[](https://github.com/gander-tools/osm-tagging-schema-mcp/actions/workflows/publish-npm.yml)7[](https://github.com/gander-tools/osm-tagging-schema-mcp/actions/workflows/publish-docker.yml)89<!-- Package Information -->10[](https://www.npmjs.com/package/@gander-tools/osm-tagging-schema-mcp)11[](https://github.com/gander-tools/osm-tagging-schema-mcp/releases)1213<!-- Dependencies -->14[](https://www.typescriptlang.org/)15[](https://modelcontextprotocol.io)16[](https://github.com/openstreetmap/id-tagging-schema)1718<!-- Code Quality & Security -->19[](https://biomejs.dev/)20[](https://www.npmjs.com/package/@gander-tools/osm-tagging-schema-mcp)21[](docs/deployment/security.md#slsa-build-provenance)2223<!-- Project Information -->24[](https://www.gnu.org/licenses/gpl-3.0)25[](https://github.com/gander-tools/osm-tagging-schema-mcp/commits/master)26[](https://github.com/gander-tools/osm-tagging-schema-mcp/issues)27[](https://github.com/gander-tools/osm-tagging-schema-mcp/pulls)2829[](https://lobehub.com/mcp/gander-tools-osm-tagging-schema-mcp)3031## What is this?3233This is a **Model Context Protocol (MCP) server** designed specifically for AI agents and LLM applications. It acts as a bridge between artificial intelligence systems and the comprehensive OpenStreetMap tagging knowledge base provided by the official `@openstreetmap/id-tagging-schema` library.3435**Current Status**: Production-ready MCP server, actively maintained and continuously improved. The service is deployed and accessible at [https://mcp.gander.tools/osm-tagging/](https://mcp.gander.tools/osm-tagging/).3637**We welcome your feedback!** Have ideas for improvements? Found a bug? Want to discuss features? Please open an [issue](https://github.com/gander-tools/osm-tagging-schema-mcp/issues) or start a [discussion](https://github.com/gander-tools/osm-tagging-schema-mcp/discussions).3839## What this is NOT4041⚠️ **Important clarifications:**4243- **Not a standalone application**: This server requires integration with AI systems (like Claude Code or Claude Desktop) to be useful. It has no user interface or web frontend.44- **Not for direct human use**: Without an AI agent as an intermediary, this tool provides no value to end users. It's designed exclusively for programmatic access by LLM applications.45- **Not a public API for general use**: The deployed service at mcp.gander.tools is intended for integration with AI agents, not for direct HTTP requests or high-volume automated queries. Please do not attempt to abuse the service with DDoS attacks or excessive traffic.4647If you're looking for a user-facing OSM tagging tool, consider [iD editor](https://github.com/openstreetmap/iD) or [JOSM](https://josm.openstreetmap.de/) instead.4849## Features5051**7 MCP Tools** organized into 3 categories:5253- **Tag Query** (2 tools): Query tag values and search tags54- **Preset Discovery** (2 tools): Search and explore OSM presets with detailed configurations55- **Validation** (3 tools): Validate tags, check for deprecated tags, suggest improvements5657📖 **Full tool reference**: [docs/api/](./docs/api/README.md)5859## Installation6061### Using npx (Recommended)6263```bash64# No installation needed - run directly65npx @gander-tools/osm-tagging-schema-mcp66```6768### Using Docker6970```bash71# Run with stdio transport72docker run -i ghcr.io/gander-tools/osm-tagging-schema-mcp:latest73```7475📖 **More options**: [docs/user/installation.md](./docs/user/installation.md) (source installation, verification, troubleshooting)7677## Quick Start7879### With Claude Code CLI8081```bash82# Add to Claude Code83claude mcp add --transport stdio osm-tagging-schema -- npx -y @gander-tools/osm-tagging-schema-mcp8485# Use in conversations86# Ask Claude: "What OSM tags are available for restaurants?"87# Ask Claude: "Validate these tags: amenity=parking, capacity=50"88```8990### With Claude Desktop9192Add to your Claude Desktop configuration:9394```json95{96 "mcpServers": {97 "osm-tagging-schema": {98 "command": "npx",99 "args": ["@gander-tools/osm-tagging-schema-mcp"]100 }101 }102}103```104105📖 **Next steps**:106- [Configuration Guide](./docs/user/configuration.md) - Setup for Claude Code/Desktop and custom clients107- [Usage Guide](./docs/user/usage.md) - Tool examples and workflows108- [API Reference](./docs/api/README.md) - Complete tool documentation109- [Deployment Guide](./docs/deployment/deployment.md) - Production HTTP/Docker deployment110111### Testing with MCP Inspector112113Test and debug the server using the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector):114115```bash116# Test published package (quickest)117npx @modelcontextprotocol/inspector npx @gander-tools/osm-tagging-schema-mcp118119# Test Docker image120npx @modelcontextprotocol/inspector docker run --rm -i ghcr.io/gander-tools/osm-tagging-schema-mcp121```122123The Inspector provides an interactive web UI to test all tools, inspect responses, and debug issues.124125📖 **Complete inspection guide**: [docs/development/inspection.md](./docs/development/inspection.md) (includes HTTP transport testing)126127## Development128129Built with **Test-Driven Development (TDD)** and **Property-Based Fuzzing**:130- Comprehensive test suite (unit + integration) with 100% pass rate131- Property-based fuzz tests with fast-check for edge case discovery132- Continuous fuzzing in CI/CD (weekly schedule + on every push/PR)133134```bash135npm install # Install dependencies136npm test # Run all tests137npm run test:fuzz # Run fuzz tests138npm run build # Build for production139```140141📖 **Development guides**: [docs/development/development.md](./docs/development/development.md) | [docs/development/fuzzing.md](./docs/development/fuzzing.md)142143## Contributing144145Contributions welcome! This project follows **Test-Driven Development (TDD)**.1461471. Fork and clone the repository1482. Install dependencies: `npm install`1493. Create a feature branch1504. Write tests first, then implement1515. Ensure all tests pass: `npm test`1526. Submit a pull request153154📖 **Guidelines**: [docs/development/contributing.md](./docs/development/contributing.md)155156## Documentation157158### Quick Navigation159160**Choose your path:**161162| I want to... | Go to |163|-------------|-------|164| **Install and run the server** | [Installation Guide](./docs/user/installation.md) |165| **Configure with Claude Code/Desktop** | [Configuration Guide](./docs/user/configuration.md) |166| **Learn how to use the tools** | [Usage Guide](./docs/user/usage.md) → [API Reference](./docs/api/README.md) |167| **Test and debug the server** | [Inspection Guide](./docs/development/inspection.md) |168| **Deploy in production (HTTP/Docker)** | [Deployment Guide](./docs/deployment/deployment.md) |169| **Fix issues or errors** | [Troubleshooting Guide](./docs/user/troubleshooting.md) |170| **Contribute to the project** | [Contributing Guide](./docs/development/contributing.md) |171172### Complete Documentation173174**User Guides:**175- [Installation](./docs/user/installation.md) - Setup guide (npx, Docker, source)176- [Configuration](./docs/user/configuration.md) - Claude Code/Desktop configuration177- [Usage](./docs/user/usage.md) - Tool examples and workflows178- [API Reference](./docs/api/README.md) - Complete tool documentation179- [Troubleshooting](./docs/user/troubleshooting.md) - Common issues and solutions180181**Developer Docs:**182- [Contributing](./docs/development/contributing.md) - Contribution guidelines (TDD workflow)183- [Development](./docs/development/development.md) - Development setup and debugging184- [Inspection](./docs/development/inspection.md) - MCP Inspector testing guide185- [Fuzzing](./docs/development/fuzzing.md) - Security fuzzing and property testing186- [Roadmap](./docs/development/roadmap.md) - Project roadmap and future features187- [Release Process](./docs/development/release-process.md) - Release and publishing workflow188189**Deployment Docs:**190- [Deployment](./docs/deployment/deployment.md) - HTTP/Docker production deployment191- [Security](./docs/deployment/security.md) - Security features, provenance, and SLSA192193**Project Info:**194- [CHANGELOG.md](./CHANGELOG.md) - Version history195196## License197198GNU General Public License v3.0 - See [LICENSE](./LICENSE) file for details.199
Full transparency — inspect the skill content before installing.