使用说明
项目简介
本项目是一个基于Model Context Protocol (MCP) 的服务器实现,旨在为LLM(大型语言模型)客户端提供上下文信息和工具能力。目前,该服务器实现了一个简单的天气预报工具,可以根据用户提供的经纬度查询当地的天气信息。
主要功能点
- 天气预报工具: 提供查询天气预报的功能,LLM可以通过调用此工具获取指定位置的天气信息。
- MCP协议支持: 遵循MCP协议规范,可以与任何支持MCP协议的LLM客户端(如Claude Desktop)进行交互。
- JSON-RPC通信: 使用JSON-RPC协议与客户端进行通信,实现请求和响应的标准化。
安装步骤
-
安装Node.js 和 npm: 确保你的电脑上已经安装了Node.js和npm(Node.js包管理器)。你可以从 https://nodejs.org/ 下载并安装。
-
下载仓库代码: 从 https://github.com/MCP-Mirror/Alesion30_my-mcp-server 下载仓库代码到本地。
-
安装依赖: 在仓库根目录下,打开终端并执行以下命令安装项目依赖:
npm install -
构建项目: 执行以下命令构建项目,生成可执行的JavaScript文件:
npm run build构建成功后,会在项目根目录下生成 'build' 文件夹,可执行文件 'main.js' 位于 'build' 文件夹内。
服务器配置
要将此MCP服务器配置到MCP客户端(例如 Claude Desktop),你需要提供服务器的启动命令和参数。以下是针对 Claude Desktop 的配置示例,你需要根据你的实际环境进行调整。
在 Claude Desktop 的配置文件 'claude_desktop_config.json' 中 (macOS 路径: '~/Library/Application\ Support/Claude/claude_desktop_config.json'),添加或修改 'mcpServers' 配置项,加入以下server配置:
{ "mcpServers": { "myMcp": { "command": "node", "args": ["/path/to/your/my-mcp-server/build/main.js"] } } }
配置参数说明:
- '"myMcp"': 服务器名称,可以自定义,用于在客户端中标识该服务器。
- '"command": "node"': 启动服务器的命令,这里使用 'node' 命令来运行JavaScript文件。请确保 'node' 命令在你的系统环境变量 'PATH' 中,或者提供 'node' 的完整路径 (例如: '/usr/local/bin/node')。 你可以使用命令 'which node' 查找 'node' 的完整路径。
- '"args": ["/path/to/your/my-mcp-server/build/main.js"]': 传递给 'node' 命令的参数,这里指定了服务器入口文件 'main.js' 的路径。 请将 '/path/to/your/my-mcp-server/build/main.js' 替换为你本地 'my-mcp-server' 仓库中 'build/main.js' 文件的绝对路径**。** 你可以使用 'find 'pwd' -maxdepth 2 -name main.js' 命令在项目根目录下查找 'main.js' 的完整路径。
配置完成后,重启 Claude Desktop 客户端,客户端应该就能检测到并连接到你的 MCP 服务器了。
基本使用方法
配置并启动 MCP 服务器后,在 Claude Desktop 中,你可以尝试询问天气相关的问题,例如:
サンフランシスコの天気は? (旧金山的天气怎么样?)
如果 MCP 服务器配置正确,Claude 应该能够调用天气预报工具,并结合天气信息给出回答。 你可以根据 README.md 中提供的图片示例进行效果验证。
注意: 该天气预报工具目前仅支持美国地区的天气查询,使用的天气数据来源于美国国家气象局 (National Weather Service)。
信息
分类
网页与API