返回 MCP 目录
public公开dns本地运行

Sample-Model-Context-Protocol-Demos

该项目提供了一系列使用AWS Model Context Protocol(MCP)的示例模块,涵盖了多种语言和技术栈,包括TypeScript、Python、Spring AI等,展示了MCP在客户端-服务器通信、ECS部署、RAG集成等场景下的应用。

article

README

🚀 模型上下文协议(MCP)示例集合

本项目提供了一系列模型上下文协议(MCP)的示例,展示了不同语言和框架下 MCP 的应用场景,帮助开发者更好地理解和使用 MCP。

🚀 快速开始

项目提供了多个不同的 MCP 示例模块,你可以根据自己的需求选择合适的模块进行参考和使用。

✨ 主要特性

  • 涵盖多种编程语言和框架,包括 TypeScript、Python、Spring AI & Kotlin、Spring AI & Java。
  • 提供不同通信方式的示例,如 MCP/SSE、MCP/stdio。
  • 包含在不同环境下的部署示例,如 ECS。
  • 部分示例结合了检索增强生成(RAG)技术。

📦 安装指南

文档未提供具体安装命令,暂不展示安装指南相关内容。

💻 使用示例

基础用法

本项目提供了多个不同的示例模块,以下为各模块的简单介绍: | 模块名称 | 详情 | | ---- | ---- | | 服务器客户端 MCP/SSE 演示 | 该示例使用 TypeScript 语言,创建了一个使用 converse API 和 MCP 服务器的 Amazon Bedrock MCP 客户端。样本通过容器部署,使用 MCP/SSE 相互通信。 | | 服务器客户端 MCP/stdio 演示 | 此示例基于 Python 语言,是一个简单的演示,展示了一个使用 converse API 和 MCP 标准输入输出(stdin/stdout)的 Amazon Bedrock MCP 客户端。该样本可以在本地运行并与 Amazon Bedrock 连接。 | | 服务器客户端 MCP/SSE 在 ECS 上 | 该示例使用 Spring AI & Kotlin,提供一个在 ECS 上运行的 Spring AI MCP 服务器示例;该服务器被一个同样在 ECS 上运行的 Spring AI Agent 使用,后者通过负载均衡器公开访问。 | | 服务器客户端 MCP/SSE 在 Bedrock Converse 客户端中使用 pgVector RAG | 此示例基于 Spring AI & Java,是一个基于 Bedrock 的 Spring AI 狗狗收养代理,使用 PostgreSQL 和 pgvector 进行检索增强生成(RAG),以及一个 MCP 服务器来管理收养预约。 | | MCP/SSE 服务器在 ECS 上 | 该示例使用 Spring AI & Kotlin,是一个非常基础的 Spring AI MCP 服务器,使用 Server - Sent Events (SSE) 在 ECS 上运行。 |

📚 详细文档

安全

有关更多详细信息,请参阅 CONTRIBUTING

📄 许可证

该库采用 MIT - 0 许可证。有关详细信息,请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端