项目简介

该项目是一个基于Model Context Protocol (MCP) 实现的应用后端,旨在为大型语言模型(LLM)客户端提供可调用的工具服务。它目前集成了第三方API,提供实时天气查询和基于谷歌搜索结果的热点事件查询功能。

主要功能点

  1. 实时天气查询: 通过调用和风天气API,获取指定城市的当前天气信息。
  2. 热点事件搜索: 利用Serper API,根据用户提供的关键词进行谷歌搜索,获取相关热点事件或新闻。

安装步骤

  1. 下载代码: 从GitHub仓库克隆或下载项目代码到本地。
  2. 配置API密钥: 编辑项目的 'application.yml' 或通过环境变量、命令行参数,配置和风天气API密钥('weather.api.api-key')和Serper API密钥('serper.api-key')。
  3. 构建项目: 使用Maven打包项目,生成可执行的JAR文件。在项目根目录运行命令:
    mvn clean package -Dmaven.test.skip=true
    这会在 'target' 目录下生成一个JAR文件。

服务器配置 (供MCP客户端使用)

MCP客户端(如基于'langchain4j-mcp'的客户端)需要配置启动该MCP服务器的命令。典型的配置会包含:

  • 启动命令: 指定运行该服务器的命令,通常是 'java'。
  • 命令行参数: 传递给启动命令的参数。这会包含 '-jar' 选项后跟生成的服务器JAR文件的完整路径,以及用于传入API密钥的参数,例如:
    • '--weather.api.api-key=你的和风天气API密钥'
    • '--serper.api-key=你的Serper API密钥'
  • 其他配置: 根据所使用的MCP客户端库,可能还需要配置服务器名称等信息。

重要提示: 请将命令行参数中的 '你的和风天气API密钥' 和 '你的Serper API密钥' 替换为你自己的实际API密钥。

基本使用方法

一旦服务器通过MCP客户端成功启动和连接,LLM客户端就可以像调用内部函数一样调用服务器暴露的工具。例如,通过兼容的LLM客户端,可以:

  • 询问天气:"请告诉我武汉现在的天气如何?"
  • 查询热点事件:"获取谷歌当前有关小米SU7的热点事件。"

客户端库(如'langchain4j-mcp')会负责将LLM的意图转化为对服务器工具的JSON-RPC调用。

信息

分类

网页与API