OpenStreetMap标记模式MCP服务器
   ](https://github.com/gander-tools/osm-tagging-schema-mcp/actions/workflows/publish-docker.yml)
](https://www.npmjs.com/package/@gander-tools/osm-tagging-schema-mcp) ](https://github.com/gander-tools/osm-tagging-schema-mcp/releases)
  
 ](https://www.npmjs.com/package/@gander-tools/osm-tagging-schema-mcp) 
  ](https://github.com/gander-tools/osm-tagging-schema-mcp/issues) ](https://github.com/gander-tools/osm-tagging-schema-mcp/pulls)
](https://lobehub.com/mcp/gander-tools-osm-tagging-schema-mcp)
这是什么?
这是一个 模型上下文协议(MCP)服务器 专为AI代理和LLM应用而设计。它充当人工智能系统和官方提供的全面OpenStreetMap标签知识库之间的桥梁 @openstreetmap/id-tagging-schema 图书馆。
当前状态:生产就绪的MCP服务器,积极维护并不断改进。该服务已部署并可在以下位置访问 https://mcp.gander.tools/osm-tagging/.
这不是什么
⚠️ 重要澄清:
- 不是独立的应用程序:此服务器需要与AI系统(如Claude Code或Claude Desktop)集成才能使用。它没有用户界面或web前端。
- 不供人类直接使用:如果没有人工智能代理作为中介,这个工具对最终用户没有任何价值。它专为LLM应用程序的编程访问而设计。
- 不是通用的公共APImcp.gander.tools部署的服务旨在与AI代理集成,而不是用于直接HTTP请求或高容量自动查询。请不要试图通过DDoS攻击或过度流量滥用服务。
特性
7 MCP工具 分为3类:
- 标签查询 (2个工具):查询标签值和搜索标签
- 预设发现 (2个工具):搜索和探索具有详细配置的OSM预设
- 验证 (3个工具):验证标签,检查弃用的标签,提出改进建议
📖 完整工具参考: docs/api/
安装
使用npx(推荐)
# No installation needed - run directly
npx @gander-tools/osm-tagging-schema-mcp使用Docker
# Run with stdio transport
docker run -i ghcr.io/gander-tools/osm-tagging-schema-mcp:latest📖 更多选项: docs/user/installation.md (源安装、验证、故障排除)
快速开始
使用Claude Code CLI
# Add to Claude Code
claude mcp add --transport stdio osm-tagging-schema -- npx -y @gander-tools/osm-tagging-schema-mcp
# Use in conversations
# Ask Claude: "What OSM tags are available for restaurants?"
# Ask Claude: "Validate these tags: amenity=parking, capacity=50"使用克劳德桌面
添加到您的Claude Desktop配置中:
{
"mcpServers": {
"osm-tagging-schema": {
"command": "npx",
"args": ["@gander-tools/osm-tagging-schema-mcp"]
}
}
}📖 下一步:
MCP检验员测试
使用官方测试和调试服务器 MCP检查员:
# Test published package (quickest)
npx @modelcontextprotocol/inspector npx @gander-tools/osm-tagging-schema-mcp
# Test Docker image
npx @modelcontextprotocol/inspector docker run --rm -i ghcr.io/gander-tools/osm-tagging-schema-mcpInspector提供了一个交互式web UI,用于测试所有工具、检查响应和调试问题。
📖 完整的检查指南: docs/development/inspection.md (包括HTTP传输测试)
发展
内置于 测试驱动开发(TDD) 和 基于属性的模糊:
- 综合测试套件(单元+集成),合格率100%
- 基于属性的模糊测试,可快速检查边缘情况发现
- 在CI/CD中持续进行模糊测试(每周计划+每次推送/PR)
npm install # Install dependencies
npm test # Run all tests
npm run test:fuzz # Run fuzz tests
npm run build # Build for production📖 发展指南: docs/development/development.md | docs/development/flugg.md
贡献
欢迎投稿!该项目如下 测试驱动开发(TDD).
- 分叉并克隆存储库
- 安装依赖项:
npm install - 创建要素分支
- 先写测试,然后实现
- 确保所有测试通过:
npm test - 提交拉取请求
📖 指南: docs/开发/贡献.md
文档
快速导航
选择您的路径:
| 我想… | 去 |
|---|---|
| 安装并运行服务器 | 安装指南 |
| 使用克劳德代码/桌面配置 | 配置指南 |
| 学习如何使用工具 | 使用指南 → API 参考 |
| 测试和调试服务器 | 检查指南 |
| 在生产环境中部署(HTTP/Docker) | 部署指导 |
| 修复问题或错误 | 故障排除指南 |
| 为项目做出贡献 | 贡献指南 |
完整文档
用户指南:
开发人员文档:
部署文档:
项目信息:
- 更改日志.md -版本历史
许可证
GNU通用公共许可证v3.0-请参阅 许可证 文件以获取详细信息。
