stadiamaps-mcp-server-ts

🚀 Stadia Maps MCP服务器（TypeScript）

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

🚀 快速开始

构建

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

1. 运行 bun install 来获取依赖项。
2. 然后，执行构建脚本：bun run build。 构建后的代码现在应该位于 build 目录中。

配置

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

✨ 主要特性

功能

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

使用场景

以下是一些你可以提示大语言模型（LLM）使用这些工具的方式：

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

💻 使用示例

集成示例

有了API密钥后，以下是几种使用MCP服务器的方法：

Claude Desktop

有关如何使用Claude Desktop配置此MCP服务器的详细说明，请参阅Claude Desktop设置。Claude Desktop是测试工作流程的好工具。

Warp

有关如何使用此MCP服务器设置Warp的详细说明，请参阅Warp设置。Warp是一个强大的智能环境，它使用大语言模型（LLM）为你完成各种任务。与你需要将文件上传到Claude不同，Warp可以直接访问文件、编写代码并在你的计算机上执行程序。与Stadia Maps MCP结合使用时，它是进行批量地理编码、空间过滤数据集等任务的强大工具。

使用Anthropic SDK进行编程集成

对于希望将MCP服务器以编程方式集成到其TypeScript应用程序中的开发人员，我们提供了一个Anthropic SDK集成示例。此示例展示了如何：

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

📚 详细文档

技巧与窍门

大语言模型（LLM）远非完美，有时你需要精心设计提示才能获得良好的结果。

尽可能明确指定要使用的工具

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

例如，看看模型在这里的表现：

你可以像这样提示模型使用此MCP中的工具：

发挥创造力

大语言模型（LLM）功能强大，但并非无所不能。例如，让我们看看如何批量对电子表格中的地址进行地理编码。

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

提示：对这个电子表格中的所有地址进行地理编码。将地理编码后的纬度和经度作为新列添加到表格中。

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

这种创造力是必要的，特别是当通过常规用户界面与当前一代大语言模型（LLM）进行交互时。MCP的强大之处在于你可以通过代码与它们进行交互，这可以克服一些限制，提供令人愉悦的用户体验。

自定义！

就像人类一样，大语言模型（LLM）在获得适合工作的工具时表现更好。就像一位熟练的工匠一样，你可能需要一些专业知识来了解如何最好地组合合适的工具和材料。

此外，模型有上下文限制。虽然有一些高级技术可以突破这个限制，但根据你需要的特定API功能定制MCP只会对你有益。更不用说，仅使用特定上下文中所需的工具进行操作会便宜得多。在一个简单的演示中，工具架构是上下文成本的主要部分！ 如果你将工具套件扩展到约10个工具，最终可能会有数千个输入令牌。

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