osm-tagging-schema-mcp

关键词

OpenStreetMap taggingAI taggingMCP serverschema toolsprompts integration

使用说明（Markdown 摘要）

  • 项目简介

    • osm-tagging-schema-mcp 是一个生产就绪的 MCP 服务器实现，围绕 OpenStreetMap 的 tagging schema 构建后端能力，提供对资源、工具和提示的统一管理与访问，供 LLM 客户端以标准化方式读取资源、注册并执行工具、获取并渲染提示模板等。

  • 主要功能点

    • MCP 协议核心能力：实现 MCP 服务端，接收并响应客户端的 JSON-RPC 风格请求，提供工具、资源、提示等能力的注册、查询与执行。
    • 资源/工具/Prompts 的托管与管理：将 tagging schema 相关的资源、工具函数和 prompts 注册到 MCP 服务器，客户端可通过统一入口访问。
    • 数据访问与工具执行：支持读取标签字段、获取标签值、执行复杂的标签对比、转换等工具，以及通过 prompts 指引的多步骤工作流。
    • 多传输协议支持：默认支持 stdio 传输，此外支持通过配置启用 HTTP + SSE 等传输模式，便于不同场景的集成。
    • 会话管理与能力声明：服务器对外声明其能力（工具、Prompts），并在会话中管理传输和请求上下文。
    • 测试与扩展性：提供完整的测试用例与集成测试示例，便于持续集成和 fuzz 测试。

  • 安装步骤

    • 环境准备：需要 Node.js 环境（建议版本与仓库依赖一致）。
    • 使用 npx 安装并运行：使用命令 npx @gander-tools/osm-tagging-schema-mcp 即可启动 MCP 服务器（无全局安装需求）。
    • Docker 运行（示例）：以 stdio 传输运行时，可以使用 Docker 镜像 ghcr.io/gander-tools/osm-tagging-schema-mcp:latest 启动，容器内默认命令会以 stdio 启动 MCP 服务。
    • 测试与调试：仓库提供了丰富的测试用例和 Inspector 调试指南，可结合 MCP Inspector 验证工具、请求和响应。

  • 服务器配置（MCP 客户端连接用的 JSON 配置说明）

    • 服务端名称（serverName 对应 MCP 服务中的服务标识）
    • 启动命令与参数（command 和 args）
    • 传输方式与端口等配置项（若使用 HTTP/SSE，需要相应的端口与跨域来源等设置）
    • 下面给出一个准确示例描述，便于 MCP 客户端在读取配置时理解用途（说明性文本，不是代码块）

    示例配置说明（JSON 结构描述，供 MCP 客户端读取）：

    • serverName: "osm-tagging-schema"
    • command: "npx"
    • args: ["@gander-tools/osm-tagging-schema-mcp"]
    • transports: ["stdio"] // 如需通过 HTTP 连接，请设置为 ["stdio","http"] 并在服务器端启用对应传输
    • httpConfig: { port: 3000, host: "0.0.0.0", corsOrigins: ["http://localhost:6274","https://mcp.ziziyi.com"] }
    • notes: 在默认配置下，若未设置 TRANSPORT，服务器将使用 stdio（与 MCP Inspector/CLI 集成最常见），若需要通过 HTTP/SSE 进行远程交互，请使用 HTTP 传输模式并设置相应端口和 CORS 来源。

  • 基本使用方法

    1. 启动服务器
      • 通过 npx 启动：npx @gander-tools/osm-tagging-schema-mcp
      • 通过 Docker 启动（示例）：docker run -i ghcr.io/gander-tools/osm-tagging-schema-mcp:latest
    2. 与 MCP 客户端对接
      • 客户端需要提供服务器名称、启动命令和参数来创建连接（如上述 JSON 配置所示）。
      • MCP Inspector 等工具可用于测试服务器能力、列出工具、获取预设详情等。
    3. 常见操作
      • 列出工具、读取资源、获取标签值、执行比较、转换工具等，结合测试用例可验证各工具的输出结构与一致性。
    4. 生产部署与监控
      • 参考仓库提供的部署指南（HTTP/Docker 部署、SLSA 构建等）实现生产就绪的 MCP 服务，并搭配日志系统进行运行时监控。

  • 其他注意事项

    • 该实现关注 MCP 协议的核心能力、资源与工具的托管，以及 Prompt 的渲染与执行。对外提供了完整的 API，适配多种客户端（包括 Claude Code/Desktop 等 AI 辅助系统）。
    • 如需自定义配置，请参考仓库中的文档与示例（Installation、Configuration、Deployment 等章节）。

服务器信息

访问项目