模型上下文协议服务器集合

一个展示多种自定义服务器实现的集合,用于探索和演示模型上下文协议(MCP)如何连接大型语言模型(LLMs)与各种数据源和API,以执行更复杂的上下文感知任务。

  • by lumalisan
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 lumalisan/mcp-collection

使用说明

带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项目中通常使用以下技术和工具:

📂 存储库结构和使用

此存储库由驻留在其中的每个不同的MCP服务器实现组织 自己的专用目录 (例如。, 01-weather/, 02-pokemon/).

要开始使用特定的MCP:

  1. 克隆此存储库。
  2. 导航到您感兴趣的MCP目录。
  3. 跑 pnpm install (或您最喜欢的包管理器)。
  4. 跑 pnpm dev 尝试MCP检查器。
  5. 当你准备好尝试使用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示例很有用!