使用说明
带Typescript的模型上下文协议(MCP)服务器集合
🎯 关于此收藏
欢迎来到我的模型上下文协议(MCP)服务器实现库!
该项目展示了各种定制的服务器,旨在探索和演示模型上下文协议的强大功能。MCP是一个新兴标准,旨在简化大型语言模型(LLM)如何安全地连接和利用各种数据源、外部API和其他工具。我在这里的目标是提供实用的、动手的例子,说明MCP如何充当桥梁,使LLM能够通过与现实世界的服务交互来执行更复杂、上下文感知的任务。
请随意探索代码,了解不同MCP的结构,并获得灵感!
✨ 你会在里面找到什么
以下是您可以探索的MCP的一些关键方面和示例:
- 多样化的服务整合: 将LLM连接到各种有用服务的MCP服务器示例,包括:
- ☀️ 天气MCP: 提供当前天气、每日/每小时预报和空气质量数据(使用Open-Meteo API)。
- 👾 神奇宝贝API MCP: 允许LLM获取有关Pokémon、其能力、统计数据等的详细信息(使用PokéAPI)。
- 实际MCP实施: 每个项目都演示了MCP的核心概念,如工具定义、输入/输出模式(使用Zod)和通过MCP SDK的通信处理。
- 授权LLMs: 这些服务器如何为LLM提供必要的上下文和功能以回答特定查询或执行操作的清晰示例。
- 模块化和可理解的代码: 专注于干净、有组织的代码。例如,Weather MCP演示了API调用和地理编码的解耦逻辑,以获得更好的可维护性。
🚀 使用的核心技术
这些MCP项目中通常使用以下技术和工具:
- 运行时环境: Node.js
- MCP开发: @模型上下文协议/类型脚本sdk
- 语言: TypeScript
- 架构定义和验证: 萨德
- 集成的关键API(示例):
📂 存储库结构和使用
此存储库由驻留在其中的每个不同的MCP服务器实现组织 自己的专用目录 (例如。, 01-weather/, 02-pokemon/).
要开始使用特定的MCP:
- 克隆此存储库。
- 导航到您感兴趣的MCP目录。
- 跑
pnpm install(或您最喜欢的包管理器)。 - 跑
pnpm dev尝试MCP检查器。 - 当你准备好尝试使用AI的MCP时,你需要对其进行配置。这取决于你的客户端,但典型的配置如下:
{
"mcpServers": {
"weather": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tsx",
"[your local path to \01-weather]"
]
}
}
}
在VS代码中安装
您还可以使用VS Code CLI安装MCP服务器:
# For the weather MCP server
code --add-mcp '{"name":"weather","command":"npx","args":["-y","tsx","[your local path to \01-weather]"]}'
安装后,MCP服务器将可用于VS Code中的GitHub Copilot代理。
这里的大多数服务器都设计为通过以下方式进行通信 stdin/stdout 使用 StdioServerTransport 如示例所示。
截图
天气MCP
口袋妖怪MCP
编码愉快,我希望你发现这些MCP示例很有用!
