项目简介
该项目是一个基于Model Context Protocol (MCP) 实现的应用后端,旨在为大型语言模型(LLM)客户端提供可调用的工具服务。它目前集成了第三方API,提供实时天气查询和基于谷歌搜索结果的热点事件查询功能。
主要功能点
- 实时天气查询: 通过调用和风天气API,获取指定城市的当前天气信息。
- 热点事件搜索: 利用Serper API,根据用户提供的关键词进行谷歌搜索,获取相关热点事件或新闻。
安装步骤
- 下载代码: 从GitHub仓库克隆或下载项目代码到本地。
- 配置API密钥: 编辑项目的 'application.yml' 或通过环境变量、命令行参数,配置和风天气API密钥('weather.api.api-key')和Serper API密钥('serper.api-key')。
- 构建项目: 使用Maven打包项目,生成可执行的JAR文件。在项目根目录运行命令:
这会在 'target' 目录下生成一个JAR文件。mvn clean package -Dmaven.test.skip=true
服务器配置 (供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