🚀 Stadia Maps MCP服务器（TypeScript）
这是一个模型上下文协议（MCP）服务器，它能让AI助手访问Stadia Maps的API，以提供位置服务、地理编码、路线规划和地图绘制等功能。
🚀 快速开始
构建
我们将使用 bun 来执行所有指令，但你也可以使用 npm。
- 运行
bun install来获取依赖项。 - 然后，执行构建脚本：
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个工具，最终可能会有数千个输入令牌。
这个项目是一个起点，我们在中添加了注释，说明了我们构建工具的方法，以及你如何根据自己的用例进行定制。