Stadia Maps MCP Server (TypeScript)

这是一个模型上下文协议（MCP）服务器，它为AI助手提供了访问Stadia Maps API的能力，用于位置服务、地理编码、路线规划和地图生成等功能。

<a href="https://glama.ai/mcp/servers/@stadiamaps/stadiamaps-mcp-server-ts"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=4051982988,4087486784&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Stadia Maps 地理位置 API 服务器 MCP 服务器" /> </a>

功能

• 地球上任何地方的时间信息
  • 当前时间
  • 时区信息（ID、UTC偏移量以及是否生效特殊偏移如夏令时）
• 地理编码
  • 地址查询
  • 地点搜索（如餐馆、咖啡馆等兴趣点）
• 静态地图图像生成（包括标记和路线覆盖层）
• 路线规划及旅行时间
• 等时线（可达范围；包括时间和距离轮廓）

使用场景

这里有一些使用LLM的方法示例：

• "东京现在几点？"
• "给我制作一张从Depoo Turg到Põhjala Tap Room的步行路线图。"
• "Põhjala Tap Room现在开放吗？使用Stadia Maps获取此信息。"
• "对附件电子表格中的地址进行地理编码。"

快速开始

构建

我们将使用bun来执行所有指令，但你也可以使用npm。

1. 运行bun install以获取依赖项。
2. 然后，执行构建脚本：bun run build。

构建好的代码应该现在位于build目录中。

配置

此MCP服务器需要一个Stadia Maps API密钥。请按照此处的说明获取你的免费密钥。然后，在运行服务器时设置API_KEY环境变量。

集成示例

拥有API密钥后，这里有一些使用MCP服务器的方式。

Claude Desktop

请参阅Claude Desktop 设置，了解详细配置此MCP服务器与Claude Desktop的说明。Claude Desktop是一个很好的测试工作流程的工具。

Warp

请参阅Warp 设置，了解详细设置Warp与这个MCP服务器的说明。Warp是一个强大的代理环境，使用LLMs为你做事。与你需要将文件上传到Claude不同，Warp可以直接访问文件、编写代码并执行程序。

结合Stadia Maps MCP，它是一个处理批量地理编码、空间过滤数据集等任务的强大工具。

通过Anthropic SDK编程集成

对于希望将MCP服务器编程集成到他们的TypeScript应用程序中的开发者，我们有一个Anthropic SDK 集成示例。此示例演示了如何：

• 从代码连接到MCP服务器
• 与Claude的API集成以进行自然语言查询
• 使用Stadia Maps API通过MCP服务器增强Claude的空间智能

小贴士和技巧

LLMs远非完美，有时你需要花些心思来设计提示语句以获得良好的结果。

在可能的情况下，具体指定要使用的工具

有时模型需要一点提示才能使用正确的工具。例如，如果你询问营业时间，许多模型会尝试在网上搜索。这些信息并不总是容易被模型在线找到。

例如，看看模型在这里做了什么：

你可以这样引导模型使用MCP中的工具：

发挥创意

LLMs能够做很多事情，但它们不能总是完成一切。举个例子，让我们看看一种批量地理编码电子表格中地址的方法。

首先，在Claude Desktop中附加一个Excel表格，其中包含一列地址。

提示： 对这个电子表格中的所有地址进行地理编码。在表格中添加新的列，记录地理编码后的纬度和经度。

撰写本文时，Claude无法直接生成电子表格附件，但它可以生成HTML页面或其他代码来自动生成！事实上，Claude Desktop可能会询问你是否想要下载Excel表格，但它会直接为你生成这个文件。

这种创造力是必要的，特别是在通过常规用户界面与当前一代LLMs交互时。MCPs的一大优势在于你可以通过代码与其互动，这可以克服一些限制，提供令人愉悦的用户体验。

定制它！

就像人类一样，当给LLMs提供合适的工具时，它们表现得更好。就像一位大师工匠，你可能需要一些专业知识来知道如何最好地组合合适的工具和材料。

此外，模型有上下文限制。虽然有高级技术可以从中榨取更多内容，但根据你需要的具体API功能定制MCP只会对你有益。而且，只使用你需要的特定上下文的工具，对你来说将便宜得多。工具模式在简单的演示中占据了绝大多数的上下文成本！ 如果你构建出大约10个工具的套件，最终可能会有数万个输入令牌。

这个项目只是一个起点，我们在index.ts中留下了注释，说明了我们构建工具的方法，以及如何根据你的用例定制它们。