GenAI MCP 服务器示例套件（EKS 实现）

关键词

上下文服务工具编排LLM 集成图像处理信用评估

使用说明内容（Markdown格式）

  • 项目简介

    • 本仓库包含多个基于 MCP 的服务端实现，用于演示在后端以标准化方式向 LLM 客户端提供资源、工具和提示模板的能力。核心服务包括收入/就业验证、地址验证、图像处理等 MCP 服务器，以及一个示例计算工具服务器，用于展示多服务器协作与工具注册。

  • 主要功能点

    • 实现 MCP 协议核心能力，暴露可被 MCP 客户端发现和调用的工具（Tools）。
    • 通过 SSE/HTTP 等传输方式与客户端通信，支持会话管理与能力声明。
    • 具备多服务协作能力：收入/就业验证、地址验证、图像处理等服务互相通过 MCP 调用。
    • 集成可选追踪/观测（如 Langfuse）以便对调用链进行追踪。
    • 提供示例服务的运行脚本，便于本地或容器化环境快速启动。

  • 安装步骤

    1. 克隆或下载本仓库。进入包含 MCP 服务器实现的目录，例如 income/employment 验证、地址验证、图像处理等脚本所在位置。
    2. 安装依赖（示例中的 Python 服务通常需要 Python 环境和相关依赖，如 fastmcp、langchain、fastapi 等，请在每个服务目录下按照需求安装）。
    3. 逐个启动 MCP 服务器（每个服务在独立终端或容器中运行）：
      • income_employment_validation_service：运行相应的 Python 脚本，包含端口与传输设置（如 SSE）。
      • address_validation_service：运行对应脚本，端口与传输设置同上。
      • image_processor：启动图像处理 MCP 服务器，端口设置同上。
      • calculator：启动简单计算工具服务器，作为额外示例。
    4. 启动 MCP 客户端并使用服务列表进行联邦调用测试（请参考 MCP 客户端的使用方式）。

  • 服务器配置（MCP 客户端所需的启动信息）

    • 说明：MCP 客户端需要知道如何启动并连接到各个 MCP 服务器。以下为示意性的 JSON 配置，包含服务器名称、启动命令与参数说明。请在实际环境中按需调整路径和参数。 { "servers": [ { "server_name": "income_employment_validation_service", "command": ["python", "workshops/eks-genai-workshop/static/code/module3/credit-validation/mcp-income-employment-validator.py"], "args": [] }, { "server_name": "address_validation_service", "command": ["python", "workshops/eks-genai-workshop/static/code/module3/credit-validation/mcp-address-validator.py"], "args": [] }, { "server_name": "image_processor", "command": ["python", "workshops/eks-genai-workshop/static/code/module3/credit-validation/mcp-image-processor.py"], "args": [] }, { "server_name": "calculator", "command": ["python", "examples/mcp-server/calculator/server.py"], "args": [] } ] }

  • 基本使用方法

    • 逐个启动上述 MCP 服务器，确保它们在可用的端口（如 8000 及以上）上监听，并使用 SSE/HTTP 等传输方式对外暴露工具接口。
    • 启动后，在 MCP 客户端中加载并查询可用工具，然后按照需要对某个客户端流程发起调用，进行信息提取、验证、推理等工作流。
    • 如遇到异常或速率限制，请按服务器提示进行重试、排错或延时重试。

  • 运行与测试注意事项

    • 由于各服务可能依赖外部组件（如 S3、Langfuse、OpenAI/Bedrock 等），请确保在运行前正确配置所需的环境变量与依赖。
    • 某些服务器示例需要网络访问与 AWS 配置，请在安全合规的环境中运行。
    • 由于示例代码中包含模拟数据与虚拟服务，请不要将其直接用于生产环境，如需生产，请替换为真实数据源与严格的安全控制。

  • 说明与限制

    • 该仓库中的 MCP 服务为演示/学习用途，展示 MCP 协议的服务器端实现及与客户端的交互方式，实际部署时应加强安全性、错误处理和日志管理。

服务器信息

访问项目